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.
A thorough, highly actionable multi-phase workflow with strong validation checkpoints and concrete MCP calls. Its main weakness is repetition — the SCOPE LIMITS block appears twice verbatim — and inlining of large prompt templates that could be factored into a reference file.
Suggestions
De-duplicate the SCOPE LIMITS block: define it once and reference it from both the Phase A and Round 2+ prompt templates, or extract it to a referenced file.
Remove self-referential meta-commentary such as "Earlier wording used 'or' + a stale verdict set; the AND form is authoritative" — state only the authoritative rule.
Factor the full Round 2+ prompt template into a reference file and keep SKILL.md focused on the workflow, reducing inline token weight.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly lean and assumes Claude's competence (no priming on what MCP or Gemini is), but the SCOPE LIMITS block is duplicated verbatim across both prompt templates and there is self-referential meta-commentary ("Earlier wording used...the AND form is authoritative") that could be trimmed. | 4 / 5 |
Actionability | Provides fully executable guidance: exact MCP tool names with parameters, polling instructions, a concrete JSON state schema, and copy-paste-ready prompt templates covering the common round-1 and round-N+ cases. | 5 / 5 |
Workflow Clarity | Clear phase sequence (Initialization → Loop Phases A–E → Termination) with explicit validation gates — STOP CONDITION check, a verbatim raw-response save checkpoint, compaction-recovery state persistence, and a review→fix→re-review feedback loop. | 5 / 5 |
Progressive Disclosure | Well-organized into clear sections with one-level-deep external references (shared-references/*.md), but no bundle files exist and the large duplicated SCOPE LIMITS block plus full prompt templates are inlined where a single referenced file would reduce repetition. | 4 / 5 |
Total | 18 / 20 Passed |