Content
72%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
A well-structured router skill that excels at progressive disclosure and gives concrete, actionable navigation. Its main weaknesses are redundant mapping repetition across three sections and a decision tree without validation checkpoints or consistent numbering.
Suggestions
Collapse the overlapping Quick Reference, Decision Tree, and Example Invocations into a single canonical routing table to remove triple-repeated mappings and save tokens.
Normalize the decision-tree numbering (replace 3a/3b/3c and 23a with a flatter, consistent scheme) so the routing sequence is unambiguous.
Add an explicit validation checkpoint for the migration path (e.g. 'After choosing a migration reference, confirm the schema change is covered before editing') since this skill routes to destructive database operations.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | It does not explain concepts Claude already knows, but the same symptom-to-reference mappings are repeated across the Quick Reference table, Decision Tree, and Example Invocations (e.g. SwiftData → skills/swiftdata.md appears three times), so the token budget could be tightened. | 2 / 3 |
Actionability | Routing guidance is concrete and executable throughout — specific file paths (skills/grdb.md), named auditor agents to launch (core-data-auditor), and slash commands (/axiom:audit core-data), which is the correct actionable form for an instruction/router skill. | 3 / 3 |
Workflow Clarity | The numbered Decision Tree provides a clear routing sequence, but there are no validation/feedback checkpoints and the numbering is inconsistent (3, 3a, 23, 23a); given it routes to destructive database-migration work, the missing guardrails cap clarity at 2. | 2 / 3 |
Progressive Disclosure | A textbook router structure: a concise SKILL.md overview pointing one level deep to well-signaled reference files via the Quick Reference table and Decision Tree, with content appropriately split out rather than inlined. | 3 / 3 |
Total | 10 / 12 Passed |