# Code Linting

> Run linters according to repository guidelines. Use immediately after creating or modifying code, or before committing changes.

- Skill: `majiayu000/code-linting` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds add majiayu000/code-linting`
- Raw SKILL.md: https://api.skillmd.com/api/skills/majiayu000/code-linting/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: majiayu000 (https://skillmd.com/u/majiayu000)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/majiayu000/code-linting

---


# 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

```bash
# 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."