Content
81%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 is highly actionable and workflow-safe, with explicit validation checkpoints and feedback loops for fragile batch phylogenetic operations. Its main weaknesses are verbatim command repetition that hurts conciseness and an incomplete References section that leaves some bundle files under-signaled.
Suggestions
Deduplicate the repeated `phykit_batch_analysis` batch command blocks — show each operation once and reference it, removing the verbatim saturation/treeness repeats.
Complete the References section to list every bundle file actually used, including `references/troubleshooting.md` and the `scogs_paired_compare.py` / `scogs_phykit_pipeline.py` / `phykit_batch.py` / `busco_target_orthologs.py` scripts.
Move the long PhyKIT column-parsing cheat sheet and per-metric gotchas into `references/tree_building.md` or `references/parsimony_analysis.md`, keeping only a one-line pointer and the highest-signal rules in SKILL.md.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body avoids explaining concepts Claude already knows, but it is noticeably repetitive: the `phykit_batch_analysis` saturation/treeness batch commands appear ~3 times verbatim and the `phykit_batch.py` block largely duplicates the tool-based guidance, so it could be tightened. | 3 / 5 |
Actionability | Guidance is fully executable — concrete Python imports, real bash invocations with flags (`--metric parsimony_informative`, `--per-tree-stat median`), and shown output-block formats (`# SUMMARY group=...`, `# MWU ...`) that make parsing copy-paste ready. | 5 / 5 |
Workflow Clarity | A clear sequence is enforced by RULE ZERO (check pre-computed results first), a workflow decision tree, explicit feedback loops (sanity targets → 'count files first' / 're-derive the intersection'), and a completeness checklist; the batch operations do carry validation, so the cap-at-3 rule does not apply. | 5 / 5 |
Progressive Disclosure | References are one level deep and scripts are clearly signaled inline in bash commands, and the body is well sectioned; however the References section is incomplete (it omits the existing `troubleshooting.md` and the heavily-used `scogs_*.py` scripts) and a ~500-line body inlines gotcha detail that partly belongs in the reference files. | 4 / 5 |
Total | 17 / 20 Passed |