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 strongly executable playbook: every intent maps natural-language triggers to concrete, copy-paste-ready `spektacular knowledge` commands with real validation gates around the destructive and batch operations. Token efficiency is good, with only minor repetition (chiefly the audit confirmation rule) and some shared rule material that could be split into a reference file.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense with project-specific operational knowledge Claude cannot know (checksum-based de-dup, tag prefix matching at reduced strength, prune verdict protocol, per-store citation rules) and contains no basic-concept padding. Minor over-explanation could be trimmed: the audit's propose-then-confirm rule is restated roughly four times (steps 4 and the note at the end of the audit section, then again twice in Decline handling), and the tag-form philosophy paragraphs are discursive. Efficient with minor trimmable instances — anchor 4, not 5; not 3 because almost every sentence carries a non-obvious specific. | 4 / 5 |
Actionability | Every intent supplies copy-paste-ready invocations: `spektacular knowledge search <query>` with exact flag semantics, `write --data '{"tier":…,"name":…,"path":…}' --file …`, the staged-file format with a concrete frontmatter example, the `rm` cleanup, and the prune verdict command with full JSON. Specific examples cover the common cases, matching the fully-executable anchor. | 5 / 5 |
Workflow Clarity | Each of the five intents is a clearly numbered sequence with explicit checkpoints and error feedback: the audit's per-entry confirmation gate ("an audit write without explicit user approval is a bug"), prune's dry-run preview, evidence-required verdicts with refusal messages that say how to fix them, resumability, and the CLI-refusal feedback on writes. The destructive/batch cap does not apply because validation is present throughout, so this matches the anchor with explicit validation, feedback loops, and fallbacks (e.g. inline consolidation when no sub-agent can spawn). | 5 / 5 |
Progressive Disclosure | No bundle files exist, and the single file is well organized: an overview section, a "When to invoke" section with concrete trigger phrases, and one clearly headed section per intent. Shared material (the tag-form rules) is cross-referenced rather than restated ("Apply the Choosing tag forms rules from the contribute intent unchanged — do not restate"), but at ~150 lines the tag-form rules and lookup consolidation contract are shared by multiple intents and could live one level deep in a reference file. Good structure with minor organization gaps — anchor 4, not 5. | 4 / 5 |
Total | 18 / 20 Passed |