Content
78%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, well-sequenced multi-database workflow with executable code, prerequisite/fallback handling, and strong error-recovery guidance. The main structural weakness is that everything lives in one long SKILL.md with no bundle files — the per-database tool reference and troubleshooting content would benefit from being split into one-level-deep reference files.
Suggestions
Split the per-database tool-call catalog (Phases 2–6) into a references/ file (e.g., references/tool-catalog.md), keeping SKILL.md to the workflow overview, core principles, and synthesis guidance.
Move the detailed Troubleshooting entries into a references/troubleshooting.md or trim to the most common failure modes, keeping only API-key setup and ID-resolution pitfalls inline.
Add explicit inline validation checkpoints to the phase workflow (e.g., 'confirm Ensembl/HGNC IDs resolved before Phase 3/4 calls; if empty, re-run MyGene_query_genes') instead of relying on the Troubleshooting section alone.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and tool-specific with almost no filler — API-key requirements, fallbacks, exact parameter values, and known upstream failures (the EnsemblPheno HTTP 500 note) all earn their tokens. A few sections could be trimmed, e.g., the multi-sentence G2P/GenCC concordance commentary and parts of the evidence-hierarchy paragraph restate domain knowledge Claude already has, so it sits at 'efficient; minor instances of over-explanation' rather than the lean score-5 anchor. | 4 / 5 |
Actionability | Fully executable, copy-paste-ready guidance: complete initialization (`from tooluniverse import ToolUniverse; tu.load_tools()`), exact tool names with real parameters (`DisGeNET_get_gda(gene=..., source="CURATED", min_score=0.3, limit=25)`), concrete output consumption (`g2p_hits["data"]["results"][0]["stable_id"]`), an example synthesis table, and specific troubleshooting fixes. This matches the score-5 anchor of copy-paste-ready code covering the common cases. | 5 / 5 |
Workflow Clarity | The 7-phase workflow is clearly sequenced with an ASCII overview, entry-point alternatives (gene vs disease query), input dependencies noted ('Both require pre-resolved Ensembl/EFO IDs'), and a thorough Troubleshooting section giving error→fix feedback loops for each tool. It falls short of the score-5 anchor because validation checkpoints (verify IDs resolved, confirm non-empty results before synthesis) live in Troubleshooting rather than as explicit inline checkpoints in the phase sequence. | 4 / 5 |
Progressive Disclosure | No references/, scripts/, or assets/ directories exist, and the single ~250-line SKILL.md inlines roughly 150 lines of per-tool API reference (all seven phases' call signatures, G2P/GenCC/Orphanet details, troubleshooting entries) that clearly belongs in separate reference files — mirroring the score-3 anchor of well-structured content with inline material that should be split out. Section organization itself is good, which keeps it above score 2. | 3 / 5 |
Total | 16 / 20 Passed |