skills-doctorlisted
Install: claude install-skill anki1kr/second-nature
# Skills doctor
A skill that cannot run is worse than no skill: the agent keeps the instructions and quietly invents whatever the
broken helper was supposed to compute. This finds those, before they are trusted.
```bash
python doctor.py # full report (from inside this skill folder)
python doctor.py --broken # only what cannot run here
python doctor.py --root ~/.agents/skills --fix-reqs # write requirements.txt where imports have no manifest
```
Standard library only, read-only unless `--fix-reqs` is passed, no network.
## What it checks, and why each check exists
| Check | Why |
| --- | --- |
| Third-party imports that are **not installed here**, and whether the skill ships a requirements file | the failure that shipped in a real skill: a Pydantic v1 engine on a Pydantic v2 machine, so every function the skill told the agent to call was unreachable |
| Duplicate `name:` in front matter | two skills claiming one name: whichever loads first wins and the other is invisible dead weight |
| Trigger collisions (how many descriptions answer the same word) | 30+ skills answering "design" or "review" makes the picker a lottery; that is why behaviour feels inconsistent |
| `allowed-tools` naming another assistant's tools | `default_api`, `web_browser_agent`, `google:search` match nothing here, so the skill silently loses its tools |
| Instructions to run destructive git commands | `git reset --hard` / `checkout --` / `clean` destroy uncommitted work; a skill must nev