Content
73%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-architected workflow skill with a clear sequenced process, explicit validation and recovery loops, and a QA checklist, supported by a properly disclosed reference bundle. It loses points for repeated install guidance and a dangling reference to a nonexistent examples/ directory.
Suggestions
Consolidate the duplicated install/probe commands: keep the canonical set in workflow step 0 and have the "Missing dependency behavior" section reference it rather than restating the same commands.
Inline one minimal copy-paste pubfig and one pubtab example in the body so the common case is fully executable without first opening a recipe file.
Remove or fix the "see examples/" pointer at the end of Resources, since no examples/ directory exists in the bundle.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is directive and assumes Claude's competence without explaining concepts, but the install/probe guidance is repeated across "0. Probe the environment" and the "Missing dependency behavior" section (same helper commands restated), which is more than minor padding and could be consolidated. | 3 / 5 |
Actionability | Provides concrete executable commands ("python3 scripts/ensure_publication_tooling.py --require pubfig --json", "pubtab xlsx2tex ...") and concrete good defaults ("one pubfig call + one save_figure(...)", "batch_export(...)"), but the main figure-generation Python patterns are delegated to recipe references rather than given as inline copy-paste code, leaving minor gaps. | 4 / 5 |
Workflow Clarity | A clear numbered 0–7 workflow with explicit validation checkpoints (probe → report available/missing → auto-install → re-run probe), an error-recovery feedback loop (install fails → degrade gracefully), and a concrete publication QA checklist, matching the explicit-validation anchor. | 5 / 5 |
Progressive Disclosure | SKILL.md is a well-structured overview with a Resources section giving one-line descriptions of one-level-deep references, all verified to exist except the referenced "examples/" directory which is absent, a navigation gap that keeps it below the clean-navigation anchor. | 4 / 5 |
Total | 16 / 20 Passed |