Content
77%Reviews 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 with a clearly sequenced, validated workflow and valuable API-quirk corrections Claude would not otherwise know. Its weaknesses are conciseness (a large placeholder report template and duplicated parameter tables) and the absence of progressive disclosure for a skill this size.
Suggestions
Move the large report template and the 'Quick Reference: Verified Tool Parameters' table into separate reference files (e.g. references/report-template.md, references/tool-params.md) and link to them from SKILL.md to improve progressive disclosure and cut inline tokens.
Deduplicate the parameter guidance: the 'Known Parameter Corrections' table and the 'Quick Reference' table cover overlapping ground — merge them into one reference.
Trim the report template's '[Researching...]' placeholder skeleton to a compact outline so the body stays lean while still defining report structure.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly efficient concrete tool calls and parameter corrections, but the ~175-line report template filled with '[Researching...]' placeholders and the duplicated parameter tables ('Known Parameter Corrections' vs 'Quick Reference: Verified Tool Parameters') could be tightened; not every token earns its place. | 2 / 3 |
Actionability | Provides fully executable python tool calls with exact parameters (e.g. 'tu.tools.ensembl_lookup_gene(gene_id=ensembl_id, species="homo_sapiens")'), explicit scoring logic, and a worked EGFR/NSCLC example — copy-paste ready. | 3 / 3 |
Workflow Clarity | Phases 0-10 are clearly sequenced with 'Phase 0 ... ALWAYS FIRST', a mandatory completeness checklist, fallback chains, and evidence-grading checkpoints providing explicit validation and error-recovery feedback loops. | 3 / 3 |
Progressive Disclosure | The skill is well-organized by section but monolithic at ~1200 lines with no bundle files; large blocks (the report template, parameter reference tables, example execution) that could be split into separate reference files are inlined, matching the level-2 anchor. | 2 / 3 |
Total | 10 / 12 Passed |