lint

Use when running or guiding deterministic Python quality checks, including linting, typing, test, and policy validation workflows. Invoke for ruff, ty, or pre-commit checks.

Stars 33

Forks 4

Install this agent skill to your Project

npx add-skill https://github.com/Jamie-BitFlight/claude_skills/tree/main/plugins/python-engineering/skills/lint

SKILL.md

Lint

Deterministic quality check workflow.

Input

Scope: $ARGUMENTS

Steps

Detect the repo's configured checkers from .pre-commit-config.yaml and CI config
Run deterministic checks that already exist in the project
Run plugin policy checks when appropriate
Report failures grouped by category
Fix only when the user asked for fixing; otherwise review and explain

Commands to Run

bash

# Formatting
uv run ruff format --check $ARGUMENTS

# Linting
uv run ruff check $ARGUMENTS

# Type check — detect from hooks/CI
uv run ty check $ARGUMENTS
# If project runs mypy: uv run mypy $ARGUMENTS

# Tests (if scope includes test files)
uv run pytest $ARGUMENTS -v --tb=short

Policy Checks

bash

# Typing boundary policy (Any outside boundary modules)
bash ${CLAUDE_PLUGIN_ROOT}/scripts/check-typing-boundaries.sh $ARGUMENTS

Output

Group results by category:

text

## Lint Results

### Formatting
✅ Pass / ❌ Fail (N issues)

### Linting
✅ Pass / ❌ Fail (N issues: list rule IDs)

### Type Checking
✅ Pass / ❌ Fail (N issues)

### Policy
✅ Pass / ❌ Fail (Any usage outside boundary modules: list files)