Content
75%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 highly actionable with a complete executable script and a clear sequenced workflow backed by validation guards and a trust-boundary checklist. Its main weakness is conciseness — the banner/narration contract is repeated across three sections — and some inline detail could be offloaded to referenced files.
Suggestions
Collapse the banner/plan narration into a single source of truth: define it once in Narration Rules and have Steps 0–1 reference it instead of restating it, to remove the triplicated explanation.
Move the verbose violation/normal narration examples and possibly the Trust Boundary precondition detail into the referenced `.claude/rules/cursor-cli-only.md` (or a references file), keeping SKILL.md as a lean overview.
Add an explicit error-recovery loop in Step 2 (e.g., on root-not-found or cursor-companion failure, surface the remediation step rather than only exiting) to push workflow clarity from 4 to 5.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly efficient and project-specific (it does not explain generic concepts Claude already knows), but the banner/plan narration is restated across three sections — Narration Rules, Step 0, and Step 1 — and the violation/normal example block could be tightened, so it earns "mostly efficient but could be tightened" rather than the lean 4 or 5. | 3 / 5 |
Actionability | Step 2 provides a fully executable, copy-paste-ready bash block with real error handling (empty-question exit, plugin-root resolution fallback, exit 2 on root-not-found), and Quick Reference plus the use-case table cover the common invocation cases. | 5 / 5 |
Workflow Clarity | Steps 0–3 are clearly sequenced with explicit validation checkpoints (empty-question guard, root-resolution guard, a Step 3 summary checklist, and the Trust Boundary preconditions table), but it lacks a true validate→fix→retry feedback loop, so it sits at 4 rather than 5. | 4 / 5 |
Progressive Disclosure | No bundle files exist, so scoring is against structure alone; the body is well-organized into clearly headed sections and the Related Skills / Rules section gives well-signaled one-level-deep references, but the inlined Narration Rules detail and Trust Boundary table could arguably live in the referenced rules file, leaving it just short of a 5. | 4 / 5 |
Total | 16 / 20 Passed |