Content
77%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.
An executable, well-gated scene layer with outstanding actionability and workflow clarity — every command is copy-paste ready and QA is enforced with reject-on-failure loops. Its weaknesses are token efficiency (pitfalls restated multiple times across sections) and progressive disclosure (four citation recipes and the IEEE layout recipe inlined in a 500-line body with no reference files).
Suggestions
State each pitfall once — either in its main section or in 'Known Issues & Pitfalls' — and cross-reference the other location, instead of repeating the \left(...\right) parse error, tc[N] guard, hanging-indent pair, recalcFields=seq, and multi-column revert rules verbatim 2–4x.
Split the four citation-style recipes (APA / Chicago / IEEE / MLA) into references/ files (e.g. references/apa.md) and keep only the shared decision table plus one exemplar recipe in SKILL.md, reducing the body by ~130 lines.
Merge 'Mental Model & Inheritance' into the opening scene-layer paragraph, which already makes the same inheritance and read-docx-v2-first points.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and task-specific with no concept padding, but several facts are repeated 2–4x: the \left(...\right) parse pitfall, the tc[N] equation guard, the 'indent=720 hangingIndent=720' canonical pair, the recalcFields=seq rule, and the multi-column no-auto-revert rule each appear in their main section and again in 'Known Issues & Pitfalls', and 'Mental Model & Inheritance' restates the opening paragraph. This fits 'mostly efficient but could be tightened' (3) rather than 'minor instances' (4). | 3 / 5 |
Actionability | Every section carries fully executable officecli commands: a Quick Start that 'validates clean', per-style citation recipes with exact --prop pairs, computed tab-stop twip positions for equation numbering, and copy-paste bash for all Delivery Gates. Matches the score-5 anchor (copy-paste ready, specific examples cover the common cases). | 5 / 5 |
Workflow Clarity | A clear 5-verb workflow (read venue spec → plan sections → set styles up front → build in order → QA) with a styles-before-content rule and an executable Delivery Gate: Gates 1–5 with REJECT/exit-1 feedback loops, a mandatory HTML visual audit checklist, and re-run guidance after mid-document inserts. Matches the score-5 anchor with explicit validation and error-recovery loops. | 5 / 5 |
Progressive Disclosure | No bundle files exist (references/, scripts/, assets/ are all absent), so all content lives in this ~500-line body: the four full citation-style recipes and the IEEE multi-column recipe are inlined where separate reference files would fit. The '→ see docx v2 §X' pointers are clearly signaled but reference a sibling skill, not a bundle. In-file sectioning is good, which lifts it above 2, but the bulk of detail is not split out, which keeps it below 4. | 3 / 5 |
Total | 16 / 20 Passed |