extend: skill-doctor — find skills that silently won't load (structural complement to skill-lint)#7
Open
deemwario wants to merge 1 commit into
Open
extend: skill-doctor — find skills that silently won't load (structural complement to skill-lint)#7deemwario wants to merge 1 commit into
deemwario wants to merge 1 commit into
Conversation
The structural-health complement to skill-lint (which judges a single skill's description quality). A dead skill symlink or a missing/invalid SKILL.md makes the skill VANISH silently — you think it's installed, the model never sees it. skill-doctor scans a skills dir (default ~/.claude/skills) and flags: broken symlinks (BROKEN_SYMLINK), no SKILL.md (NO_SKILL_MD), missing frontmatter / name so it won't register (NO_FRONTMATTER / NO_NAME), duplicate skill names (DUP_NAME), name/dir mismatch + stray entries (heuristic). Never tracebacks on permission errors / symlink loops. Exit 0/1/2; --json for CI. Structural/registration only — not description quality (that's skill-lint). - single-file python3, stdlib only; test_skill-doctor.sh 20/20 green. - house-style README with the deemwar.com/contact CTA. MIT.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Extend:
skill-doctor— find skills that silently won't load#ossengine cycle 17 —
extend the family, additive, no owner gate. The structural-health complement toskill-lint.Why
skill-lintjudges a single skill's description quality. Nothing checked the skills directory for structural health — and a dead skill symlink or a missing/invalidSKILL.mdmakes the skill vanish silently: you think it's installed, the model never sees it.What it does
Scans a skills dir (default
~/.claude/skills) and flags:BROKEN_SYMLINK(HIGH) — symlinked skill whose target is goneNO_SKILL_MD(HIGH) — skill dir with noSKILL.mdNO_FRONTMATTER/NO_NAME(HIGH) — won't register (registration only — not description quality)DUP_NAME(MED) — two skills claim the same nameNAME_MISMATCH/STRAY_ENTRY(LOW, heuristic)Exit
0/1/2;--jsonfor CI; honest disclaimer (structural, not quality/correctness).Verification (independently re-run)
test_skill-doctor.sh— 20/20 green.--json→{skills_dir, skills_scanned, findings, summary}.~/.claude/skills(38 skills) it caught a genuine issue (a skill dir with noSKILL.md).deemwar.com/contactCTA. MIT.🤖 Generated with Claude Code