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.
An exceptionally actionable, well-validated skill body with executable recipes for every citation style and an honest, gated QA process. Its main weaknesses are cross-section repetition of a few rules and a monolithic structure that could offload the long per-style recipes into reference files.
Suggestions
De-duplicate rules stated in multiple places (caption placement, hanging-indent pair, section-break +1 offset) by stating each once and cross-referencing from the other locations.
Move the four per-style citation recipe details into a references/ file (e.g. CITATION_STYLES.md) and keep SKILL.md as the decision guide + Quick Start, improving progressive disclosure.
Tighten the 'What academic means here (identity)' section, which restates deltas already enumerated in the Requirements section.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Dense with genuinely non-obvious, high-value content (SEQ cached-value trap, /section[last()] rejection, OMML pitfalls) and assumes Claude's competence, but several rules are restated across sections — caption placement, hanging-indent pair, and section-break +1 offset each appear 2-3 times — which could be trimmed. | 4 / 5 |
Actionability | Fully executable, copy-paste-ready bash throughout: a ten-line Quick Start that validates clean, complete per-style citation recipes (APA/Chicago/IEEE/MLA), equation insertion, SEQ/PAGEREF fields, and the multi-column recipe — all with exact --prop flags and QA grep commands. | 5 / 5 |
Workflow Clarity | Clear 5-verb workflow sequence followed by an executable Delivery Gate with explicit validation checkpoints (Gate 4 citation round-trip, Gate 5a SEQ presence + distinct cached numbers), REJECT/fix/re-validate feedback loops, and an 8-item visual audit checklist (Gate 5b). | 5 / 5 |
Progressive Disclosure | Well-organized into clear sections and models itself as a scene layer with one-level-deep '→ see docx v2 §X' references, but no bundle files exist and the four full per-style citation recipes plus equations/multi-column are all inlined in a ~500-line SKILL.md rather than split into separate reference files. | 4 / 5 |
Total | 18 / 20 Passed |