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.
Highly actionable content with concrete, verified tool calls and sensible fallback chains, but the single-file structure inlines what should be a separate API-reference file, and repeated status warnings inflate the token budget. The workflow is clear but stops short of defining the final synthesis/report phase.
Suggestions
Move the EBI Proteins tool tables (Phase 4d plus the variant/coordinate/epitope tables and Tool Parameter Reference rows) into a references/ file (e.g. ebi-proteins-tools.md) and keep only a one-line summary table in SKILL.md, linking to it.
State the broken `EBIProteins_get_rna_editing` endpoint once — in the Fallbacks table — and reference it from Limitations instead of repeating the full 404 evidence in three places.
Add a short Phase 5 section specifying the required report structure (per-site evidence tier, enzyme, functional consequence, isoform/entry provenance) so the workflow's final phase is defined.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly dense operational content (tool calls with literal parameters), but the `EBIProteins_get_rna_editing` broken-endpoint warning is repeated three times (Phase 4d, Fallbacks, Limitations), the coordinate-mapping tools are covered twice with overlapping prose, and multiple date-stamped status notes ('checked 2026-10-08', 'verified live') are not confined to a deprecated/status section. Not score 4 because the repetition and duplicated EBI prose go beyond minor trimming. | 3 / 5 |
Actionability | Calls are copy-paste ready with real parameter values — `iPTMnet_get_ptm_sites(operation="get_ptm_sites", uniprot_id="P04637")`, `EBIProteins_get_proteins_by_genomic_loc(taxonomy="9606", location="17:7676154")` — and include invocation syntax (`tu run EBIProteins_get_rna_editing '{...}'`), verified outputs, and expected-result examples (TP53 mapping, insulin cleavage). Not score 4 because the common cases are covered with executable, literal examples. | 5 / 5 |
Workflow Clarity | The Phase 0→5 sequence is clear with per-phase fallbacks and some checkpoints (probe iPTMnet once for 503 before switching, 'always check total_entries/total_variants' for isoform ambiguity, evidence-graded synthesis). Not score 5 because Phase 5 'Synthesis & Report' is named in the workflow but has no corresponding section defining what the report must contain. | 4 / 5 |
Progressive Disclosure | Section structure and tables are good, but there is no bundle: the ~50 lines of EBI Proteins tool tables, the verified-live examples, and the Tool Parameter Reference are exactly the API-reference material that belongs in a separate reference file inlined into SKILL.md. The single external pointer (`src/tooluniverse/data/ebi_proteins_ext_tools.json`) is a repo path, not a clearly-signaled one-level-deep bundle reference. Not score 4 because a substantial, separable reference block is inline. | 3 / 5 |
Total | 15 / 20 Passed |