custom-claude-skills/skills/linter/SKILL.md

name, description, user_invocable

name	description	user_invocable
linter	Audit and manage project formatters/linters. Scan mode checks setup; run mode formats all files.	true

/linter Skill

linter

You are running the /linter skill. Parse the arguments to determine the mode:

• /linter or /linter scan → Scan mode (default)
• /linter run → Run mode (format all files)
• /linter cleanup → Clean up orphaned .pre-lint files

Scan Mode (default)

Audit the current project's formatter setup:

1. Find file types — Use find or Glob to identify all file extensions in the project (exclude .git/, node_modules/, vendor/, etc.)
2. Check formatters/ directory — Does it exist? What symlinks are present?
3. Check tool availability — For each formatter, verify the required tool is installed (ruff, shfmt, shellcheck, biome, sqlfluff, prettier)
4. Check config files — For each formatter, check if the project has the expected config file (pyproject.toml, .editorconfig, biome.json, .sqlfluff, .prettierrc)
5. Check pre-commit hook — Is pre-commit-lint.sh installed as a git pre-commit hook?
6. Check orphaned .pre-lint files — Any leftover checkpoint files from interrupted lint runs?

Present results as a table:

Extension | Files | Formatter | Tool | Config | Status
----------|-------|-----------|------|--------|-------
.py       | 12    | ✓ py      | ✓ ruff | ✓ pyproject.toml | Ready
.sh       | 8     | ✓ sh      | ✓ shfmt, ✓ shellcheck | ✗ .editorconfig | Missing config
.ts       | 0     | ✗         | -    | -      | No files

Then suggest commands to fix any issues:

• Missing formatters: setup-formatters.sh <project> <ext> ...
• Missing tools: install commands
• Missing configs: create minimal config files
• Orphaned .pre-lint files: list them and offer to clean up

Run Mode (/linter run)

Format and lint all files in the project:

1. Verify formatters/ exists
2. Create a git stash checkpoint: git stash push -m "pre-linter-run"
3. Find all files with matching formatters
4. Run each formatter on matching files
5. Collect and report errors
6. Show git diff --stat summary of changes
7. If errors remain, list them and suggest fixes

Cleanup Mode (/linter cleanup)

Find and remove orphaned .pre-lint files:

1. Search for *.pre-lint files in the project
2. List them with their age
3. Remove them (they're just blob SHA references or file copies)