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 strong, highly actionable academic-paper skill with executable recipes and rigorous validation gates. Its main weaknesses are mild duplication of pitfalls across sections and a monolithic structure that could be split into reference files for better progressive disclosure.
Suggestions
Consolidate duplicated pitfalls (the \left/\right parse error, section-break +1 offset, and hanging-indent canonical form each appear in both their feature section and Known Issues) into a single canonical location with cross-references.
Split the four per-style citation recipes (APA, Chicago, IEEE, MLA) and the equation/multi-column details into separate reference files under references/, keeping SKILL.md as a decision-guide overview that points to them.
Trim or link-out the repeated restatements of inherited docx rules (e.g. heading hierarchy numbers, shell-quoting rules) to a single `→ see docx v2 §X` pointer per topic.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly efficient — it explicitly inherits docx base rules ('is inherited, not re-taught') and leans on `→ see docx v2 §X` rather than restating them — but several pitfalls are duplicated across sections (the `\left/\right` parse error, section-break +1 offset, and `indent=720 hangingIndent=720` canonical form each appear twice), so not every token earns its place. | 4 / 5 |
Actionability | Fully executable copy-paste bash throughout: a validating 10-line Quick Start skeleton, per-style citation recipes, equation/SEQ/PAGEREF/multi-column examples, and concrete QA-gate scripts — specific examples cover the common cases. | 5 / 5 |
Workflow Clarity | A clear 'Workflow — 5 verbs' sequence is followed by an executable Delivery Gate with explicit validation checkpoints (Gates 4, 5a, 5b) and REJECT/re-run feedback loops, plus a mandatory visual-audit checklist (a–h) for error recovery. | 5 / 5 |
Progressive Disclosure | Good structure with clearly signaled one-level-deep references to docx v2, but the ~500-line file is monolithic — the four citation recipes, equation details, and multi-column recipe are all inlined rather than split into per-topic reference files, so content that could be separate stays inline. | 4 / 5 |
Total | 18 / 20 Passed |