Content
60%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 body delivers a well-sequenced, highly actionable workflow with real scripts, checklists, and verified bundle references, but it is substantially over budget: duplicated listings, an off-topic schematic-generation section, and requirement tables inlined from the reference files bloat the token cost. Two cited file paths also do not exist in the bundle, which breaks otherwise copy-paste-ready commands.
Suggestions
Cut the 'Visual Enhancement with Scientific Schematics' section, the 'Summary' section, and the duplicated style-guide/resource listings in 'Resources' — the Resources section alone already indexes every bundle file.
Move the page-limit, citation-style, and figure-requirement tables out of SKILL.md into the existing references/journals_formatting.md and references/conferences_formatting.md, replacing them with one-line pointers.
Fix broken bundle references: scripts/generate_schematic.py (belongs to the scientific-schematics skill, not this bundle) and assets/posters/tikzposter_research.tex, which does not exist in assets/posters/.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The ~690-line body is noticeably verbose with several padded sections: an off-topic 'Visual Enhancement with Scientific Schematics' section promoting a different skill, a 'Summary' section that restates the frontmatter description, style-guide and resource listings duplicated between 'Writing Style Guides' and 'Resources → Bundled Resources', and long venue enumerations plus page-limit/citation/figure tables that duplicate content already delegated to references/journals_formatting.md and references/conferences_formatting.md. This matches anchor 2 ('noticeably verbose; several unnecessary explanations or padded sections') rather than 3, because the padding is systematic rather than incidental, and not 1 because there is little explanation of concepts Claude already knows. | 2 / 5 |
Actionability | Mostly executable guidance: concrete invocations of scripts/query_template.py, scripts/customize_template.py, and scripts/validate_format.py with flags, pdflatex/bibtex/latexmk compile sequences, review checklists, and worked examples with real requirements. It falls short of anchor 5 because two cited files do not exist in the bundle (scripts/generate_schematic.py and assets/posters/tikzposter_research.tex), leaving those commands/examples broken as written. | 4 / 5 |
Workflow Clarity | The 'Finding and Using Templates' workflow is a clear six-step sequence (identify venue → query template → review requirements → customize → validate → compile and review) with a validation step (validate_format.py) and explicit review checklists. It matches anchor 4 ('clear sequence with most checkpoints present; minor validation gaps') rather than 5 because there is no explicit error-recovery feedback loop (e.g. what to do when validation fails), and rather than 3 because checkpoints are explicit, not merely implied. | 4 / 5 |
Progressive Disclosure | Scored against the actual bundle: all 11 references/*.md files, all 4 assets/examples files, all template directories, and all three scripts referenced in the body exist, and the 'Resources' section signals them clearly at one level deep. This fits anchor 4 ('good structure; most content is appropriately placed; references mostly clear; minor organization gaps') — it is not 5 because substantial detail content (venue lists, requirement tables) that belongs in the existing reference files is inlined in SKILL.md, and two referenced paths are missing from the bundle. | 4 / 5 |
Total | 14 / 20 Passed |