Content
73%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 dense, highly actionable skill: concrete templates for every artifact, an explicit reviewer feedback loop with bounded polling, and fallbacks for missing inputs. The main costs are token efficiency — key rules are repeated up to three times across Constants, Step 2, and Key Rules — and reliance on external ../../shared-references/ files that are not part of the bundle.
Suggestions
State each page-budget and section-count rule once (in Constants) and drop the repetitions in Step 2 and Key Rules to reclaim tokens without losing clarity.
Either vendor the three shared output-protocol files into the skill's references/ directory or inline one-line summaries, since ../../shared-references/ links fall outside the bundle and cannot be relied on.
Consider moving the three venue-specific section templates and the citation rules into a references/ file, keeping SKILL.md as a decision guide for which template applies.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly efficient templates rather than concept explanation, but key rules are stated redundantly: MAX_PAGES scope is defined in Constants, restated in Step 2 ('The total page budget MUST sum to MAX_PAGES'), and repeated twice in Key Rules ('Page budget is hard' and 'MAX_PAGES counts main body only'); section-count flexibility also appears in both Step 2 and Key Rules. This matches 'Mostly efficient but includes some unnecessary explanation or could be tightened'; a 4 would need only minor trims. | 3 / 5 |
Actionability | Every step ships a concrete, fill-in markdown template (Claims-Evidence Matrix, section-by-section plan, Figure Plan, Citation Plan, output document), plus an explicit MCP call for review with polling instructions — mostly executable guidance. Minor gaps: the review prompt is a template with placeholders rather than a fully worked example, and citation verification delegates to unspecified search tooling, keeping it just below 'copy-paste ready' 5. | 4 / 5 |
Workflow Clarity | A clear 7-step sequence with defined inputs and fallbacks (AUTO_REVIEW.md → ./AUTO_REVIEW.md, ask the user if nothing exists), an explicit validation/feedback loop (send outline to reviewer, poll with bounded waitSeconds until done=true, apply feedback before finalizing), and hard checkpoints (page budget must sum to MAX_PAGES, citations must be verified or flagged [VERIFY]). This matches the top anchor: clear sequence, explicit validation, feedback loops, and checklists. | 5 / 5 |
Progressive Disclosure | Good structure: the body is organized into scannable step sections with templates inline where they're needed at use time, and output protocols are delegated via clearly signaled one-level links ('[Output Versioning Protocol](../../shared-references/output-versioning.md)'). Minor organization gaps: those shared-references paths live outside the skill bundle and cannot be verified to exist, and the three full venue templates plus citation rules could arguably live in a references file. Not a 3, because references are clearly signaled and most content is appropriately placed. | 4 / 5 |
Total | 16 / 20 Passed |