Content
81%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 thorough, highly actionable skill with excellent workflow clarity and validation loops for a fragile multi-step task. Its main weakness is length and some redundancy, plus progressive-disclosure structure that relies on out-of-tree shared references rather than bundled files.
Suggestions
Collapse the 'Key Rules' list and the 'CONFIDENT PROSE, HONEST LIMITS' block, which restate each other, into a single section to cut ~60 lines of redundancy.
Move the bulk of the 'CONFIDENT PROSE, HONEST LIMITS' rules and the acknowledgements into a shared-references file linked once, keeping the inline body lean.
Bundle the referenced ../shared-references/*.md files (or at least writing-principles.md and venue-checklists.md) inside the skill so the one-level-deep references resolve within the skill directory.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly efficient and packed with domain-specific guidance Claude would not already know (venue templates, bib fetch chains, writing audits), but the ~670-line body has some redundancy — the CONFIDENT PROSE block is restated in Key Rules and acknowledgements add length — and could be tightened. | 3 / 5 |
Actionability | Provides copy-paste-ready LaTeX, bash, and Python snippets (venue setup, DBLP/CrossRef fetch chain, bib-hygiene validator) covering the common cases exhaustively. | 5 / 5 |
Workflow Clarity | Eight clearly sequenced steps with explicit validation checkpoints and feedback loops (Step 3.5 restatement audit, bib hygiene validation, Step 6 cross-review, Step 8 final checklist) for destructive/batch operations like overwriting paper/ and rebuilding the bibliography. | 5 / 5 |
Progressive Disclosure | Body signals one-level-deep references (../shared-references/*.md, templates/, helper scripts) and splits content into well-organized sections, but no bundle files are present in the skill directory and references point outside it, with some referenceable bulk (the full Key Rules / CONFIDENT PROSE blocks) kept inline. | 4 / 5 |
Total | 17 / 20 Passed |