Content
71%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 highly actionable body with excellent executable code and lean domain prose, weakened by duplication between sections and a complete failure to reference the provided scripts/ bundle, which both wastes tokens and hides capabilities like image-based colony counting. Adding fit-quality validation checkpoints to the workflows would round it out.
Suggestions
Reference the scripts/ bundle explicitly (e.g. 'See scripts/growth_curve.py for a CLI version', 'scripts/colony_counter.py counts colonies from plate images') so the 1774 lines of provided tooling are discoverable instead of re-implemented inline.
Remove the duplication between Core Capability 2 and Workflow 2 (identical 3-species Lotka-Volterra setup) and consider moving full inline implementations to reference files, keeping only Quick Start examples in SKILL.md.
Add validation checkpoints to the workflows: check R² and convergence per condition in Workflow 1, and compare models via AIC/BIC as the Best Practices section itself recommends.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The prose is lean and assumes domain competence (no explanation of what OD600 or scipy are), but the body is noticeably padded with duplication: Workflow 2 re-runs the identical 3-species Lotka-Volterra setup from Core Capability 2, and ~400 lines of inline implementations (growth models, Gillespie SSA, biofilm/CFU analysis) duplicate the 1774-line scripts/ bundle. This is more than the 'minor trimming' of the score-4 anchor. | 3 / 5 |
Actionability | Fully executable, copy-paste-ready code throughout: a working Quick Start with real OD600 data and initial guesses, complete function definitions (fit_growth_curve with parameter bounds and R², gillespie_ssa, run_prokka with error checking, GFF parsing), install commands, and concrete example inputs with expected printouts covering the common cases. | 5 / 5 |
Workflow Clarity | The 'Typical Workflows' section gives clear multi-step sequences (fit-then-compare conditions, simulate community, annotate-then-extract), and error handling exists (try/except RuntimeError on fitting, Prokka returncode check) plus a Troubleshooting section with problem/solution recovery. Not score 5 because the workflows themselves lack explicit validation checkpoints — e.g. Workflow 1's fitting loop never checks R² or handles failed convergence per condition. | 4 / 5 |
Progressive Disclosure | The body has well-organized sections (Overview, When to Use, Core Capabilities, Workflows, Best Practices, Troubleshooting, Resources), but scored against the actual bundle: the 5 provided scripts/ files (1774 lines, including colony_counter.py's image-based colony counting — a capability mentioned nowhere in the body) are never referenced, while equivalent implementations are inlined in SKILL.md. References are absent rather than 'mostly clear', so this sits at the some-structure anchor rather than 4. | 3 / 5 |
Total | 15 / 20 Passed |