---

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

Copyuv sync --all-groups

2. Format Code

Copyuv run ruff format .

3. Lint and Auto-fix

Copyuv run ruff check . --fix

4. Run Tests

Copyuv run pytest -q

On Failure

If any step fails:

1. Format fails: Check for syntax errors first
2. Lint fails: Review unfixable issues, explain the root cause
3. 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:

Copyuv 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)