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.
A well-engineered skill body: copy-paste executable commands for all three helpers, layered validation (mechanical script + manual checklist + final compliance checklist), and a clean one-level-deep reference structure. The two deductions are an orphaned `assets/examples/` directory invisible to navigation, and modest duplication between the currency rule and workflow step 1 plus a padded citation section.
Suggestions
Surface `assets/examples/` (4 bundled example files) — add a row to the reference table or link them from the relevant writing-style guides so the content is discoverable.
Merge the "Mandatory Currency Rule" details with "Verification-First Workflow" step 1, which both cover resolving venue/year/track/stage, to remove duplication.
Compress the "Citing Scientific Agent Skills" boilerplate to 3–4 lines — the current ~15 lines are mostly generic fetch/citation instructions.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and procedural — tables for references and assets, terse checklists, no explanation of concepts Claude already knows (it never explains what LaTeX or a PDF is). Minor trimming opportunities keep it below 5: the "Mandatory Currency Rule" list substantially duplicates "Verification-First Workflow" step 1 (both resolve venue/year/track/stage), and the closing citation section is ~15 lines of boilerplate that earns little of its token cost. | 4 / 5 |
Actionability | Fully executable, copy-paste-ready commands cover every helper: `python scripts/query_template.py --list-all`, the `customize_template.py` invocation with full argument examples, and two complete `validate_format.py` invocations (preset and explicit-limit). The need→reference table and asset tables give exact file paths, and workflows end in concrete verification actions — matching the 5 anchor. | 5 / 5 |
Workflow Clarity | The verification-first workflow is sequenced 1–5 with an explicit compliance-note artifact, and each of the four common workflows (conference paper, journal, grant, poster) is a numbered sequence. Validation is explicit and layered — mechanical checks via `validate_format.py`, a "Validate manually and mechanically" section, a "Review every replacement and compile before adding substantial content" feedback loop, and a 10-item final compliance checklist — matching the 5 anchor's explicit validation steps and checklists. | 5 / 5 |
Progressive Disclosure | Good structure: a need→reference table cleanly signals 11 one-level-deep reference files (all verified to exist), asset tables enumerate every bundled template, and the scripts section documents each helper. It falls short of the 5 anchor because `assets/examples/` (four bundled example files: `nature_abstract_examples.md`, `neurips_introduction_example.md`, `cell_summary_example.md`, `medical_structured_abstract.md`) is referenced nowhere in SKILL.md or in any reference file — bundled content that is undiscoverable from the skill. | 4 / 5 |
Total | 18 / 20 Passed |