Content
71%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.
A highly actionable router: exact paths, copy-paste commands, a deterministic resolution procedure with fallbacks, and a clear decision tree. Its weaknesses are token bulk — a near-complete diagnostics catalog duplicating `ls`-discoverable data plus filename repetition between tables and the decision tree — and a sole external reference (skills/apple-docs-research.md) that is not resolvable within the bundle.
Suggestions
Trim the diagnostics tables to the most common entries and lean on the existing `ls` fallback, or move the full catalog to a bundled references/diagnostics-index.md so SKILL.md stays an overview.
De-duplicate the routing decision tree, which repeats guide filenames already listed in the tables — keep one authoritative listing.
Fix the dangling skills/apple-docs-research.md references: either include the file in the bundle or state where it lives relative to this skill.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Prose is lean and assumes Claude's competence, but the body carries substantial trimmable bulk: ~50 diagnostics table rows that the skill itself admits are incomplete ("ships more files than are listed here") and discoverable via the included `ls` command, plus a routing decision tree that repeats guide filenames already tabulated above. That is more than anchor 4's 'minor instances', fitting anchor 3's 'could be tightened'. | 3 / 5 |
Actionability | Guidance is fully executable: exact base directories, a copy-paste example ("Read /Applications/Xcode.app/.../SwiftUI-Implementing-Liquid-Glass-Design.md"), a concrete `ls` command, explicit filename-to-topic tables, and a deterministic path-resolution procedure (session context → AXIOM_XCODE_PATH → `xcode-select -p` → default). Specific examples cover the common cases, matching anchor 5. | 5 / 5 |
Workflow Clarity | The path-resolution sequence is clearly ordered with explicit conditional checkpoints ("If it prints /Library/Developer/CommandLineTools, no Xcode is selected") and an error-recovery fallback chain ending in "Do not silently fail — tell the user", matching anchor 4. It falls short of anchor 5 only because there is no explicit check that a specific guide/diagnostic file exists before reading it — the ls fallback appears only in the diagnostics section's tail and the tree's 'Other' branch. | 4 / 5 |
Progressive Disclosure | The bundle contains no references/, scripts/, or assets/, and the body's only cross-references point to "skills/apple-docs-research.md", which does not exist in the bundle — a dangling reference. Meanwhile ~50 rows of diagnostics catalog are inlined in SKILL.md where the rubric expects an overview pointing to a separate index file, fitting anchor 3 ('content that should be separate is inline; references present but not clearly signaled') rather than anchor 4's 'most content appropriately placed'. | 3 / 5 |
Total | 15 / 20 Passed |