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, tool-accurate body whose commands and parameters are copy-paste ready and whose bundled scripts exist and match their documented modes. Its weaknesses are repetition of the Trimmomatic and wobble rules and the absence of any reference-file split — most detail content lives inline in SKILL.md.
Suggestions
State the Trimmomatic 'reads completely discarded = F + R + 2*D' rule once (keep the top-of-mind flag pointing to the counter table) and remove the duplicated third explanation and the repeated wobble-rules listing in the Codon-Anticodon section.
Move the Phase 1-6 tool parameter reference and the Peptide & Foldamer Structure material into reference files (e.g., references/tools.md, references/foldamers.md) and link them from a compact overview, keeping SKILL.md to workflows, gotchas, and recipes.
Update the workflow diagram to include Phases 5-6, and convert implicit verification exhortations into explicit checkpoints (e.g., 'verify ORF has no stop codons before reporting the translation').
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and operational, but the Trimmomatic discarded-reads rule is stated three times (the top-of-mind section, the counter-selection table, and the 'DO NOT report just D' paragraph), wobble pairing rules appear in both the amino_acids section and the Codon-Anticodon section, and reference material like helix types and domain-function mappings is inlined. Mostly efficient but with repeated and tighten-able material — above the 'noticeably verbose' level 2 because most content is Claude-unknown operational detail, below level 4 because the duplication exceeds 'minor instances'. | 3 / 5 |
Actionability | Guidance is fully executable: exact tool names with parameter signatures and return shapes, step-by-step recipes ('NCBI_search_nucleotide(...) -> NCBI_fetch_accessions(uids=[first_uid]) -> NCBI_get_sequence(...)'), runnable shell one-liners ('samtools depth -a alignment.bam | awk ...'), and script invocations whose --type modes were verified against the bundled scripts (count_residues/count_region/gc_content/reverse_complement/stats; codon_table/amino_acid/count_codons/wobble; receptor/ion_channel/neurotransmitter/immune_cell/gene_confusion). Copy-paste ready and covering the common cases, matching the top anchor. | 5 / 5 |
Workflow Clarity | The Phase 1->4 workflow diagram, RULE ZERO check-for-precomputed-results-first gate, concrete recipes, and a dedicated Fallbacks section give a clear sequence with most checkpoints and error-recovery paths present. Not 5: the workflow diagram omits Phases 5-6 (domain architecture, variant/clinical), and validation checkpoints are largely implicit (e.g., 'verify' exhortations rather than validate-then-proceed steps). Not 3: the fallback section and check-first gate provide real error recovery beyond a bare step list. | 4 / 5 |
Progressive Disclosure | The four bundled scripts are real, one level deep, and clearly signaled with per-script sections and full paths — but all detail is inlined in a ~380-line monolith: the tool parameter reference, codon/wobble tables, peptide & foldamer structure, and interpretation frameworks have no separate reference files (no references/ directory exists). This matches the 'some structure; content that should be separate is inline' anchor rather than the good-split level 4. | 3 / 5 |
Total | 15 / 20 Passed |