Content
77%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The content is highly actionable with clear sequenced workflows and validation loops, but it is verbose with redundant sections and fails progressive disclosure by keeping all agency specs and drafting guidance inline while referencing bundle files that are not present.
Suggestions
Split the per-agency Grant Type Specifications and the grant-specific drafting guidelines into a references/ file (e.g. GRANT_TYPES.md) and link to it, keeping the body as an overview.
Remove the duplicated funding-track diagram and the Parameter Pass-Through table that restates the Constants block to cut token cost.
Create the missing references/ (and scripts/) bundle directories for the referenced output-manifest.md, output-versioning.md, and extract_paper_style.py so the body's references resolve to real files.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The ~700-line body is largely justified by the multi-agency complexity, but contains redundancy: the funding/publish track is diagrammed twice (Overview and Composing sections), the Parameter Pass-Through table restates the Constants block, and 'Composing with Other Skills' overlaps the Overview — tightening would reduce tokens without losing meaning. | 2 / 3 |
Actionability | Provides concrete, executable guidance throughout: a real shell snippet for style-ref helper resolution, a literal GRANT_STATE.json schema, drafting order, figure list, and copy-paste-ready Codex MCP prompt templates with bundle contents. | 3 / 3 |
Workflow Clarity | Phases 0-5 are clearly sequenced with explicit 🚦/⛔ checkpoint markers and STOP instructions, plus validation feedback loops (review-revise rounds, CRITICAL/MAJOR/MINOR severity parsing) and state persistence for compaction recovery. | 3 / 3 |
Progressive Disclosure | The body is a long monolithic wall with grant-type specs, drafting guidelines, and examples all inline; it references bundle/shared-reference files (output-versioning.md, output-manifest.md, extract_paper_style.py) but no references/, scripts/, or assets/ directories exist in the skill, so those references cannot be verified and content that should be split out is kept inline. | 2 / 3 |
Total | 10 / 12 Passed |