Content
77%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The body is a well-structured, highly actionable two-phase workflow with explicit gates and feedback loops. Its main weakness is progressive disclosure: it references several files and a script that are not bundled, and carries some emphasis/anti-pattern verbosity that could be trimmed.
Suggestions
Ship the referenced bundle files (references/reference.md and the probe-to-investigate/brainstorm/probe-llm.md handoffs) and scripts/run-query-benchmarks.sh, or inline the essential content and drop the references.
Tighten conciseness by collapsing repeated 'MANDATORY / DO NOT skip / DO NOT wait' emphasis into a single guard statement and trimming the per-anti-pattern 'Why:' rationales.
Consider moving the full 'Usage Examples' block and the AskUserQuestion bug workaround into a reference file so the main SKILL.md stays a lean overview.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly lean and operational, but repeated emphasis ('MANDATORY', 'DO NOT skip', 'DO NOT wait'), the AskUserQuestion bug guard, and verbose 'Why:' lines on every anti-pattern add tokens that could be tightened. | 2 / 3 |
Actionability | Concrete executable guidance throughout: explicit entry/exit gates, real command invocation ('./scripts/run-query-benchmarks.sh --env staging --compare main'), file paths, token budgets, and a result-classification table. | 3 / 3 |
Workflow Clarity | A clearly sequenced two-phase workflow with explicit validation checkpoints (entry gate before Phase 2, confirm/refute criteria before execution) and feedback loops (loop back to 1.1–1.4, partial→re-probe self-transition). | 3 / 3 |
Progressive Disclosure | A References section signals one-level-deep handoff/reference files, but no references/, scripts/, or assets/ bundle directories exist, so the referenced paths (reference.md, run-query-benchmarks.sh, the probe-to-* handoff files) point to files that are not present. | 2 / 3 |
Total | 10 / 12 Passed |