← ClaudeAtlas

lint-project-skillslisted

Lint Claude Code skills and subagents for files that never load, risky skills missing a manual-only guard, drifted copies of upstream skills, and name collisions. Use when the user asks to check, audit, lint or clean up their skills or agents, says a skill "isn't showing up" or "never triggers", mentions `.claude/skills` or `.claude/agents`, or has copied skills in from another repo.
simbaTmotsi/simba-skills · ★ 2 · Code & Development · score 75
Install: claude install-skill simbaTmotsi/simba-skills
# Lint Project Skills Skills fail quietly. A file in the wrong place never loads and nothing says so; a deploy skill without a guard can be picked up by the model on its own; a copied skill keeps its old bugs after upstream fixed them. This skill finds those problems and reports them. **It is read-only until the user approves a fix.** ## Scope Ask which to lint if it is not obvious; default to all that exist: - Project: `.claude/skills/`, `.claude/agents/` (and the legacy `.claude/commands/`, for name collisions only) - Personal: `~/.claude/skills/`, `~/.claude/agents/` Plugin skills are namespaced (`plugin-name:skill-name`), so they cannot collide with these; leave installed plugins alone. ## Helper scripts The scanner and the drift classifier ship as Markdown in [scripts/](scripts/), because the plugin directory does not accept executable files. Before step 1, extract them from this skill's folder into a directory only the user can write (never `/tmp`). Extract with `awk`, which copies exactly the lines between the two fence lines; never retype the code. ```bash d=~/.cache/simba-skills/lint-project-skills; mkdir -p "$d" && chmod 700 "$d" awk '/^````/{f=!f; next} f' scripts/lint_skills.py.md > "$d/lint_skills.py" awk '/^````/{f=!f; next} f' scripts/classify_copy.sh.md > "$d/classify_copy.sh" && chmod 700 "$d/classify_copy.sh" ``` Both need only the Python standard library and git. Below, `$d` is that directory. ## Procedure 1. **Run the scanner.** `python3 "$d/lin