Code Linting

Run all appropriate linters according to repository guidelines.

When to Use This Skill

Use this skill:

Don't use:

Linter Discovery

First look for linting commands in the following order:

Directives to AI agents (CLAUDE.md , .cursorrules , .ai-rules , AGENTS.md , AGENT.md , GEMINI.md , and similar)
Repository documentation (README.md , docs/ , etc.)
Package configuration (package.json , Makefile , pyproject.toml , etc.)
Standard linter patterns for the project type

If no linting guidelines are found or they are unclear, ask the user for clarification.

Common Linter Commands

JavaScript/TypeScript

npm run lint yarn run lint pnpm run lint npx eslint .

Python

ruff check . pylint . flake8 . black --check . make lint

shellcheck .

npm run format yarn run format pnpm run format

Linting Process

For each linter found:

If it has an auto-fix mode (e.g., prettier , eslint --fix , black , ruff check --fix ), run that first
Run the linter in check mode to see if there are any remaining issues
If issues can't be fixed automatically, report them clearly

Important Rules

CRITICAL: Do NOT ignore unfixed issues!

All linting issues MUST be resolved before considering the task complete
The only exception is if the user explicitly gives permission to defer resolution
Document any issues that couldn't be auto-fixed for the user to review

Output

Report results organized by:

Auto-fixed issues: What was automatically corrected
Remaining issues: Issues requiring manual attention (list each with file, line, and description)
Recommendation: What the developer should do next

If all linting passes, simply confirm: "All linters passed."