Content
56%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-structured, comprehensive skill with a genuinely distinctive core (the two-stage outline-to-prose process and LaTeX report tooling are concrete and actionable). Its weaknesses are verbosity — long sections restating knowledge Claude already has and duplicating bundled reference files — and imperfect progressive disclosure, including bash commands pointing to scripts absent from the bundle.
Suggestions
Move Section 10 (field-specific terminology) into a new references/field_terminology.md and keep only a 2-3 line pointer, cutting ~90 lines of generally-known material.
Slim Section 8 to a short usage example plus pointers to assets/REPORT_FORMATTING_GUIDE.md and references/professional_report_formatting.md, removing the duplicated command tables and box-environment code.
Fix or remove the invocations of scripts/generate_schematic.py and scripts/generate_image.py, which do not exist in this bundle — either bundle the scripts or point to the external scientific-schematics/generate-image skills with their real locations.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The ~690-line body contains several sections explaining knowledge Claude already has: Section 10 spends ~90 lines on field-specific terminology Claude knows well (gene nomenclature italics, IUPAC names, SI units, binomial nomenclature, person-first language), Sections 2 and 6 restate generic writing principles (past tense for methods, define abbreviations, avoid jargon), and Section 8 duplicates the LaTeX command/box-environment reference that already lives in assets/REPORT_FORMATTING_GUIDE.md and assets/scientific_report_template.tex. This is 'noticeably verbose; several unnecessary explanations or padded sections' (anchor 2); it is below anchor 3 because the padding is extensive and structural, not occasional. | 2 / 5 |
Actionability | Mostly concrete and executable: the two-stage outline-to-prose process includes a worked example pair (outline then expanded prose), Section 8 provides copy-paste-ready LaTeX (box environments, table with \meansd/\sigthree commands, \makereporttitle skeleton, xelatex compile command), and the workflow gives sequenced steps. The gap keeping it from anchor 5: the bash commands invoke 'scripts/generate_schematic.py' and 'scripts/generate_image.py', which do not exist in this skill's bundle (no scripts/ directory), and core guidance defers to external skills (research-lookup, venue-templates) whose availability is unverifiable — minor but real executability gaps. | 4 / 5 |
Workflow Clarity | The 'Workflow for Manuscript Development' gives a clear four-stage sequence (Planning → Drafting → Revision → Final Preparation), the two-stage writing process is well-sequenced with numbered steps, and Stage 3 embeds verification checkpoints ('Verify all citations are accurate', 'Confirm adherence to reporting guidelines', 'Check word counts'). This matches anchor 4 ('clear sequence with most checkpoints present; minor validation gaps') — the revision checks exist but are listed as prose rather than explicit validate-then-proceed gates, which keeps it below anchor 5's feedback loops. No destructive/batch operation cap applies since this is a writing task. | 4 / 5 |
Progressive Disclosure | Structure is real and one level deep — each capability section signals its reference file ('For detailed guidance, refer to references/imrad_structure.md', etc.) and all six references/ plus three assets/ files exist and match the body's citations. But significant content that clearly belongs in those separate files is inlined anyway: Section 10 (field-specific terminology) has no reference file at all, and Section 8's full command tables and box-environment code duplicate assets/REPORT_FORMATTING_GUIDE.md. The body also cites 'scripts/generate_schematic.py' paths that don't exist in the bundle, a broken navigation pointer. This lands on anchor 3 ('content that should be separate is inline') rather than anchor 4, whose 'minor organization gaps' undersell the duplication and dangling script paths. | 3 / 5 |
Total | 13 / 20 Passed |