python-quality

Run formatting, linting, and tests using uv + Ruff + pytest

$ 安裝

git clone https://github.com/naoki1213mj/my-template /tmp/my-template && cp -r /tmp/my-template/.github/skills/python-quality ~/.claude/skills/my-template

// tip: Run this command in your terminal to install the skill

SKILL.md

View on GitHub →

name: python-quality description: Run formatting, linting, and tests using uv + Ruff + pytest

Python Quality Check Skill

Use this skill when asked to:

"check quality"
"make CI pass"
"fix lint errors"
"run tests"
"prepare for PR"

Workflow

Execute these steps in order:

1. Sync Dependencies

uv sync --all-groups

2. Format Code

uv run ruff format .

3. Lint and Auto-fix

uv run ruff check . --fix

4. Run Tests

uv run pytest -q

On Failure

If any step fails:

Format fails: Check for syntax errors first
Lint fails: Review unfixable issues, explain the root cause
Tests fail:
- Show the failing test output
- Explain the root cause
- Propose a minimal fix
- Update tests if behavior change is intentional

Quick Script

For automated checks, use:

uv run python .github/skills/python-quality/scripts/check.py

Success Criteria

All files formatted consistently
No lint errors (warnings may be acceptable)
All tests pass
No decrease in test coverage (if measured)