lint-project-skillslisted
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