Content
85%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.
The content is highly actionable with executable code, a well-sequenced workflow including explicit validation/feedback loops, and mostly lean prose. Its main weakness is progressive disclosure: the referenced shared-reference and templates/ files do not exist in the bundle, so the offloaded detail cannot be navigated or verified, and some material that belongs in separate files is inlined.
Suggestions
Ship the referenced bundle files (templates/ venue .sty/.cls files and ../shared-references/writing-principles.md, venue-checklists.md, citation-discipline.md) inside the skill, or rephrase the pointers to inline-only guidance so navigation is not broken.
Move the large venue-specific setup tables and per-section page targets into a dedicated references/venue-guide.md referenced one level deep, keeping SKILL.md as a tighter overview.
Trim motivational rationale (e.g., the "Why this matters" paragraph and methodology-provenance acknowledgements) to keep the body lean.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is largely efficient and task-focused (executable curl/bash snippets, tight venue tables, concrete page targets) with little padding of concepts Claude already knows, but a few sections over-explain rationale (e.g., "Why this matters" paragraph on hallucinated BibTeX, the acknowledgement of methodology provenance). Not 5 because these motivational passages could be trimmed; not 3 because the bulk is lean and instruction-oriented rather than verbose. | 4 / 5 |
Actionability | It provides copy-paste-ready, executable guidance throughout: exact `curl` commands for DBLP/CrossRef BibTeX fetch, concrete LaTeX documentclass/usepackage snippets per venue, a real `math_commands.tex` template, and a precise Codex MCP review invocation with model and reasoning-effort config. Covers the common cases specifically; not below 5 because the examples are complete and executable rather than pseudocode. | 5 / 5 |
Workflow Clarity | Steps 0–8 are a clearly sequenced pipeline with explicit validation checkpoints: Step 0 backs up before overwrite and cleans stale files, Step 4's verified-fetch chain is a validate→fallback loop (DBLP → CrossRef → [VERIFY]), Step 6 applies only CRITICAL/MAJOR fixes, and Step 8 is a final checklist with verification items (undefined refs, unchecked [VERIFY], stale files). Not below 5 because error-recovery feedback loops and checklists are explicit; the destructive-overwrite guidance satisfies the validation cap. | 5 / 5 |
Progressive Disclosure | The body points to three shared references (writing-principles.md, venue-checklists.md, citation-discipline.md) and a templates/ directory, but these paths resolve to `../shared-references/` and `templates/` that are not present in this skill's bundle, so the references are signaled but not verifiable as real one-level-deep files, and substantial inline reference material (venue tables, section guidelines) that could live in separate files is inlined. Not 4 because the referenced bundle files are absent and navigation cannot be confirmed; not 2 because section headers and signaled references do provide some structure rather than a monolithic wall. | 3 / 5 |
Total | 17 / 20 Passed |