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 a highly actionable, well-sequenced writing workflow with concrete code and strong validation checkpoints. Its main weaknesses are redundancy of the venue citation/page-limit rules and a monolithic structure that keeps detailed guidance inline rather than offloading it to the referenced support files.
Suggestions
State the IEEE-vs-ML citation style and page-limit rules once in a single 'Venue rules' section and reference it from Step 3, Step 4, and Key Rules instead of repeating them.
Move the per-section drafting guidelines (§0–§5 + Appendix) into a dedicated reference file (e.g. references/section-guidelines.md) and keep SKILL.md as an overview pointing to it, improving progressive disclosure.
Trim explanatory justification prose such as the 'Why this matters' paragraph under the BibTeX fetch chain, keeping only the actionable fetch chain and the [VERIFY] fallback rule.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly actionable but repeats IEEE-vs-ML citation and page-limit rules across Step 3, Step 4, and Key Rules, and includes justifying prose ('Why this matters: ...') that could be trimmed. | 2 / 3 |
Actionability | Provides copy-paste-ready executable material: venue \documentclass templates, the DBLP/CrossRef curl fetch chain, the codex MCP review invocation, math_commands, and a Python bib-filtering pattern. | 3 / 3 |
Workflow Clarity | A clear Step 0–8 sequence with explicit validation checkpoints (backup before overwrite, DBLP fallback A/B/C, reverse-outline test, and a final checklist) gives strong error-recovery feedback loops. | 3 / 3 |
Progressive Disclosure | Shared references (writing-principles.md, venue-checklists.md, citation-discipline.md) are one-level-deep and well-signaled, but the SKILL.md is monolithic with substantial inline detail that could be split out, and no bundle files exist under ./references/, ./scripts/, or ./assets/ to verify the referenced paths. | 2 / 3 |
Total | 10 / 12 Passed |