Code Linting

Run all appropriate linters according to repository guidelines.

When to Use This Skill

Use this skill:

• Immediately after creating new source code files
• Immediately after modifying existing code (functions, classes, imports, etc.)
• Immediately after completing a feature, refactor, or bug fix
• Before staging files for commit
• When build/compilation succeeds but linting hasn’t been checked
• Proactively, whenever code changes are made

Don’t use:

• When you’ve already run linting and it passed

Linter Discovery

First look for linting commands in the following order:

1. Directives to AI agents (CLAUDE.md, .cursorrules, .ai-rules, AGENTS.md, AGENT.md, GEMINI.md, and similar)
2. Repository documentation (README.md, docs/, etc.)
3. Package configuration (package.json, Makefile, pyproject.toml, etc.)
4. 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

# Shell
shellcheck .

# Multiple/Generic
npm run format
yarn run format
pnpm run format

Linting Process

For each linter found:

1. If it has an auto-fix mode (e.g., prettier, eslint --fix, black, ruff check --fix), run that first
2. Run the linter in check mode to see if there are any remaining issues
3. 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:

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

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