Content
77%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is a strong, highly actionable audit skill with a clear phased workflow and explicit verification checkpoints; its main weakness is progressive disclosure — everything lives in one ~250-line file with no reference files to offload the pattern catalog. Trimming the explanatory 'why it matters' prose would further improve token efficiency.
Suggestions
Move the 10 detection-pattern catalog (Phase 2) into a references/patterns.md file and summarize it in SKILL.md, giving one-level-deep navigation.
Tighten the Phase 3 'Why it matters' and Phase 4 severity columns to brief phrases to reduce explanatory padding.
Add an optional references/ file for the cross-auditor overlap notes so the main body stays a lean overview.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is information-dense and avoids explaining concepts Claude already knows (no 'what is URLSession' filler), but the 'Issue'/'Why it matters' prose in the Phase 3 and Phase 4 tables is explanatory padding that could be tightened without losing actionable value. | 2 / 3 |
Actionability | Each anti-pattern ships exact grep search strings, severity ratings, contextual Read-verification instructions, and a concrete 'Fix' — for an instruction-only audit skill this is copy-paste-ready, fully actionable guidance. | 3 / 3 |
Workflow Clarity | A clear five-phase sequence with intermediate outputs ('Present this map in the output before proceeding') and explicit validation checkpoints ('use Read to verify the surrounding context before reporting', 'Require evidence... don't speculate') provides strong feedback loops. | 3 / 3 |
Progressive Disclosure | The body is well-sectioned into phases rather than a monolithic wall, but no bundle files exist (references/scripts/assets all absent) and content like the 10 detection patterns or API reference stays inline, so there is no one-level-deep file split to navigate. | 2 / 3 |
Total | 10 / 12 Passed |