Content
67%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 well-structured routing skill that stays lean and points to topic files via a symptom table, a decision tree, and explicit cross-suite conflict resolution. Its weaknesses are the near-complete duplication between the Quick Reference table and the Decision Tree, and references to skills/ files that are not present in this bundle, which leaves navigation unverifiable.
Suggestions
Drop either the Decision Tree or the Quick Reference table — they map the same eight topics to the same files, so one suffices.
State how to resolve the 'skills/*.md' paths (e.g. relative to the suite root) so the routed-to files are actually findable.
Trim the bolded 'You MUST use this skill for ANY...' line, which restates the description without adding routing information.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is a lean router with no explanations of concepts Claude already knows, but the dot Decision Tree duplicates the Quick Reference table's task-to-file mapping almost entirely, and the bolded 'You MUST use this skill for ANY...' line restates the frontmatter description. Mostly efficient but could be tightened by cutting one of the duplicated mappings. | 3 / 5 |
Actionability | Concrete, specific pointers throughout: per-symptom file references ('See skills/queries.md'), exact WWDC session IDs, and doc paths. Minor gap: no guidance on how to resolve the relative 'skills/' paths to the actual suite location. | 4 / 5 |
Workflow Clarity | The decision tree gives a clear task-to-reference sequence, and conflict-resolution sections specify explicit ordering ('start with axiom-health for session lifecycle, then axiom-watchos for presentation'). No validation checkpoints are needed since the skill routes rather than mutates anything; minor gap in that lookup paths for the routed files are unstated. | 4 / 5 |
Progressive Disclosure | Anchor-5 structure — a concise overview with well-signaled, one-level-deep references organized by symptom — but the eight referenced 'skills/*.md' files are not present in the provided bundle (no references/, scripts/, or assets/ directories exist), so the navigation cannot be verified as real. Structure is clearly above anchor 3; unverifiable reference targets keep it below 5. | 4 / 5 |
Total | 15 / 20 Passed |