Content
77%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The body is highly actionable with a rigorous, validated workflow, but it is monolithic and repeats several rules (hanging indent, SEQ cached-value trap, section-numbering convention) across sections. Splitting the per-style citation recipes and the equations/multi-column guides into reference files and de-duplicating the repeated caveats would lift both conciseness and progressive disclosure.
Suggestions
De-duplicate the hanging-indent rule, the SEQ cached-value trap, and the section-numbering convention — state each once and link from the other sections to remove ~3 repeated passages.
Move the four per-style citation recipes (APA, Chicago, IEEE, MLA) and the multi-column / equations guides into reference files under references/, keeping SKILL.md as an overview with a decision table and one-level-deep pointers.
Trim venue background Claude already knows (e.g. what footnotes vs endnotes are, what IEEE is) to the skill-specific deltas only.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The file is dense and mostly assumes competence, but it re-explains the same rules in multiple places — the hanging-indent canonical form recurs in Requirements, the APA recipe, the Bibliography section, and Known Issues; the SEQ cached-value trap recurs in the cross-refs section, Gate 5a, and Known Issues — so it is efficient but could be tightened rather than earning the lean score-3. | 2 / 3 |
Actionability | Every section ships copy-paste-ready executable bash (create/open/add/close/validate, raw-set SEQ patches, query-based QA), with concrete prop values and exact xpath expressions, matching the fully-executable score-3 anchor. | 3 / 3 |
Workflow Clarity | A 5-verb workflow plus an executable Delivery Gate (Gates 1–5b) with explicit validate→reject→exit feedback loops and a per-page visual audit checklist satisfies the clear-sequence-with-validation score-3 anchor. | 3 / 3 |
Progressive Disclosure | No bundle files exist (references/scripts/assets absent), so the ~500-line skill is a single monolithic file with the four per-style recipes, equations, and multi-column guide all inline; cross-references to the sibling docx skill are clearly signaled ('→ see docx v2 §X'), but content that could be split into reference files is not, landing at score 2. | 2 / 3 |
Total | 10 / 12 Passed |