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.
The body is a well-executed router skill: concrete paths, exact filenames, an unambiguous resolution chain, and explicit fallback and error-reporting behavior. Its only weaknesses are mild redundancy between the decision tree and the catalog tables, and an external reference that is not part of the bundle.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and assumes Claude's competence — no padding explaining what Xcode or Swift is, and the tables carry real lookup data. Minor trimmable redundancy remains: the Routing Decision Tree largely re-states mappings already given in the guide-file tables, keeping it just below the every-token-earns-its-place anchor. | 4 / 5 |
Actionability | Guidance is fully executable: a copy-paste Read invocation with the complete path, exact filenames for 20 guides and ~46 diagnostics, an ls command for unlisted diagnostics, and a concrete xcode-select -p / AXIOM_XCODE_PATH resolution chain. The common cases (specific diagnostic, framework feature) are covered with ready-to-run commands. | 5 / 5 |
Workflow Clarity | As a single-task router skill the action is unambiguous: an explicit resolution precedence (session context → AXIOM_XCODE_PATH → xcode-select -p → default install), an ordered fallback list when the docs directory is absent, and explicit recovery steps ("If a diagnostic you need isn't listed above, list the diagnostics directory first") plus "Do not silently fail — tell the user". | 5 / 5 |
Progressive Disclosure | Good structure with well-organized sections and a clearly signaled one-level-deep reference in the Research Methodology section. It falls short of the top anchor because that reference (skills/apple-docs-research.md) is not part of this bundle, and the ~100-line file catalog is inlined in SKILL.md rather than split out — minor organization gaps, not the could-be-better-organized mid anchor. | 4 / 5 |
Total | 18 / 20 Passed |