Content
88%Weight 40%Scale 1-5Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is a strong router skill: fully executable paths and commands, a clear decision flow with explicit fallbacks and failure reporting, and lean lookup tables that assume Claude's competence. The only real gaps are the redundant decision tree (duplicating the tables) and a referenced file (skills/apple-docs-research.md) that is missing from the bundle.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense lookup content — literal base directories, topic-to-filename tables, and terse instructions like '20 files. Read with the path pattern {guides base}/{filename}' — with no padding or explanations of concepts Claude already knows. It is not a 5 because the Routing Decision Tree largely duplicates the topic-to-filename mapping already provided by the categorized tables, and full directory paths are repeated where a shorter pattern would do. | 4 / 5 |
Actionability | Guidance is fully executable: exact base directories, a copy-paste example Read invocation, a concrete ls fallback for unlisted diagnostics, and a prioritized path-resolution cascade (session context, AXIOM_XCODE_PATH, xcode-select -p, default /Applications/Xcode.app) covering the common cases. This matches the copy-paste-ready anchor with common cases covered. | 5 / 5 |
Workflow Clarity | The routing decision tree and the ordered path-resolution fallbacks form a clear, unambiguous sequence with explicit error-recovery branches: 'If it prints /Library/Developer/CommandLineTools, no Xcode is selected; try /Applications/Xcode.app', 'If a diagnostic you need isn't listed above, list the diagnostics directory first', and 'Do not silently fail — tell the user... which fallback you used'. The skill is read-only, so the destructive/batch validation cap does not apply. | 5 / 5 |
Progressive Disclosure | Sections are well organized with clearly signaled one-level-deep references ('see skills/apple-docs-research.md' for research beyond the bundled guides), and the routing index appropriately lives in SKILL.md so no extra file load is needed to route. It is not a 5 because the referenced skills/apple-docs-research.md is not present in the bundle (no references/, scripts/, assets/, or skills/ directories exist), leaving a dangling reference; it is above 3 because the structure and in-file navigation are otherwise clean. | 4 / 5 |
Total | 18 / 20 Passed |