Agent skill
python-quality-tooling
Use when configuring or running Python quality tools (ruff, ty, pytest, coverage, CI gates) and when enforcing a pre-merge quality checklist.
Install this agent skill to your Project
npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/data/python-quality-tooling
SKILL.md
Python Quality Tooling
Overview
Use ruff, ty, and pytest consistently through uv. Core principle: one repeatable quality gate across local and CI.
Quick Reference
| Task | Command |
|---|---|
| Lint | uv run ruff check |
| Auto-fix | uv run ruff check --fix |
| Format | uv run ruff format |
| Type check | uv run ty check |
| Test | uv run pytest |
| Coverage | uv run pytest --cov=src --cov-report=term-missing |
| Full gate (prek) | prek run -a |
| Install git hooks (prek) | prek install |
Workflow
- Install tools as dev deps (see
python-uv-project-setup). - Run all checks before commit.
- Keep CI aligned with local commands.
- If the repo uses prek, prefer
prek run -aas the single quality gate. - Pytest tests MUST be function-based (no class-based tests or
unittest.TestCase).
Example
Pre-merge gate:
uv run ruff check --fix
uv run ruff format
uv run ty check
uv run pytest --cov=src --cov-report=term-missing
Common Mistakes
- Running tools outside uv (drifts from project env).
- Skipping
prek run -awhen a repo standardizes on prek. - Running only one tool and calling it done.
Red Flags
- Direct
ruff/pytestinvocations withoutuv run. - Mixing
pre-commitandprekcommands in the same repo. - Class-based pytest tests (
class Test*) orunittest.TestCaseusage.
References
references/quality.md- Full command set and CI examplereferences/quality.md- Prek install and usage notes (preferuv tool install prek)
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
agent-ops-spec
Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.
agent-ops-state
Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.
agent-ops-spec
Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
agent-ops-state
Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.
Didn't find tool you were looking for?