name: lint description: Run code quality checks with ruff and mypy argument-hint: "[--fix|--mypy|path]"

Code Quality Checker

Run linting and type checking on the codebase.

Usage

• /lint - Run ruff on all Python files
• /lint --fix - Auto-fix ruff violations
• /lint --mypy - Also run mypy type checking
• /lint services/api - Lint specific directory
• /lint --fix --mypy - Fix issues and run type checks

Tools

• ruff - Fast Python linter (replaces flake8, isort, pyupgrade)
• mypy - Static type checker

Configuration

All tools configured in pyproject.toml:

• Line length: 120
• Target: Python 3.11
• Rules: E, W, F, I, B, C4, UP, S (security), and more

Instructions

When this skill is invoked:

1. Parse arguments:

   • --fix: Use ruff check --fix instead of ruff check
   • --mypy: Also run mypy after ruff
   • Path argument: Limit scope to that path

2. Run ruff:

   ruff check ${PATH:-.} $FIX_FLAG
   

3. If --mypy specified, run mypy:

   mypy ${PATH:-services libs}
   

4. Report results:

   • Number of issues found/fixed
   • Categorize issues (style, imports, security, types)
   • For unfixed issues, explain how to resolve

5. Common issue categories:

   • I001: Import sorting - use --fix or ruff check --select I --fix
   • F401: Unused imports - remove or mark with # noqa: F401
   • S101: Assert in non-test - move to test file or use proper validation
   • B008: Function call in default arg - use None default with internal check