Content
65%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The body is concise and well-structured with a concrete API surface, but its flagship code example is not fully executable and the skill lacks an explicit selection decision procedure and clearly signaled file navigation.
Suggestions
Make the Core Pattern snippet fully runnable by showing how `llm` and `inputs` are constructed, or mark the placeholders explicitly.
Turn the 'When To Use' bullets into an explicit decision procedure (e.g., 'If the task is persistent corpus lookup -> contextMap; if within-run compaction -> contextPolicy...').
Reframe the referenced files as one-level-deep navigation (e.g., '## References — API: see API.md; capabilities: see axir-capabilities.json; examples: see examples/') and ship them under a references/ bundle directory.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is a lean ~40 lines of terse bullets with no concept explanations or padding; it assumes Claude's competence and every section (Package Facts, Core Pattern, API Surface, Guardrails) earns its place, matching the 'lean and efficient' anchor. | 3 / 3 |
Actionability | It provides a Rust snippet and concrete API symbols plus file pointers (API.md, axir-capabilities.json, examples/), but the Core Pattern uses undefined placeholders (`&llm`, `inputs`) so it is not copy-paste executable, fitting 'some concrete guidance but incomplete.' | 2 / 3 |
Workflow Clarity | The 'When To Use' section gives selection guidance across the four features but no concrete decision sequence or validation checkpoints, matching 'steps listed but validation gaps; sequence present but checkpoints missing or implicit.' | 2 / 3 |
Progressive Disclosure | Sections are well organized, but referenced files (API.md, axir-api.json, axir-capabilities.json, examples/) are listed flat as 'Package Facts' rather than clearly signaled one-level-deep navigation, and no bundle reference directory is present to verify them. | 2 / 3 |
Total | 9 / 12 Passed |