| name | yp-diagnose |
| description | Scan all installed skills for yellowpages compliance violations and emit exact fix instructions. |
Diagnose Skills
Skill doctor. Scans all skills and emits violations as direct agent instructions — not just a report, but actionable steps the agent can execute immediately on "yes."
Scope
Scans: skills/yellowpages/, ~/.claude/skills/, and ~/.agents/skills/ if they exist.
Output format
YP DIAGNOSE — <date>
❌ CRITICAL (<N>)
───────────────
<path>/SKILL.md [<actual> lines · budget: 80 · over by <N>]
EXTRACT: lines <A>–<B> → create references/<name>.md
KEEP: lines <C>–<D> in SKILL.md (frontmatter + routing table)
ADD: "when to read" annotation to each new reference link
⚠️ WARNINGS (<N>)
─────────────────
<path>/references/<file>.md
Lines <X>, <Y>: reference links missing "when to read" annotation
ADD: annotation column to the links table at each line
✅ HEALTHY (<N>): <comma-separated list>
Fix CRITICAL issues now? [yes / no / details]
On "yes": execute the EXTRACT, KEEP, ADD, CREATE instructions in order.
References
| File | When to read |
|---|
references/standards.md | The full yellowpages compliance rules used as the check basis |
references/checks.md | Exactly what to check and how to evaluate each criterion |
references/remediation.md | How to format EXTRACT/KEEP/ADD/CREATE instructions for each violation type |
