Content
77%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
A well-structured navigation skill with clear routing logic and concrete symptom-to-file mappings, undermined mainly by repeated restatement of the same mappings and by references to skills/*.md files that are not present in the bundle.
Suggestions
Ship the referenced bundle files (skills/core-location.md, core-location-ref.md, core-location-diag.md, mapkit.md, mapkit-ref.md, mapkit-diag.md) or remove the references — progressive disclosure only works when the linked content exists.
Collapse the duplicated skill-to-topic mappings: pick one canonical routing surface (e.g. the Quick Reference table) and have the decision tree / Example Invocations point back to it instead of restating the same file list four times.
Verify the 'skills/' path prefix matches the actual bundle layout; the references use a nested skills/ path but no such directory exists in the bundle.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean routing content with no concept-padding, but the same skills/*.md -> topic mapping is restated across the Quick Reference table, the dot decision tree, the numbered decision tree, Critical Patterns, and Example Invocations, adding tokens that do not all earn their place. Not a 3 because it could be tightened by collapsing redundant mappings. | 2 / 3 |
Actionability | Gives concrete, specific routing — each symptom maps to an exact file (e.g. "Location updates never arrive -> skills/core-location-diag.md"), and the decision tree prescribes precise next steps. As an instruction-only skill, the absence of code is not penalized because the guidance is actionable and copy-paste-ready routing. | 3 / 3 |
Workflow Clarity | Sequenced decision logic (domain -> Core Location or MapKit -> type -> file) is laid out in both a graphviz decision tree and a numbered list, with example invocations. No destructive/batch operations are involved, so the absence of validation checkpoints is not penalized. | 3 / 3 |
Progressive Disclosure | The overview is well-organized into one-level-deep, clearly signaled references (main/-ref/-diag split), which would otherwise score 3, but none of the referenced files (skills/core-location*.md, skills/mapkit*.md) actually exist in the bundle, so the disclosed content cannot be navigated to. Not a 1 because the structure and signaling are genuinely sound, but not a 3 because the references do not resolve to real files. | 2 / 3 |
Total | 10 / 12 Passed |