Content
75%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 well-structured, information-dense skill body with a clear ten-phase workflow, concrete tool parameters, scoring rubrics, and error-handling guidance. Main gaps are the broken KEY PRINCIPLES list, duplication between the inline tool/scoring tables and the referenced files, and the absence of worked examples in the body itself.
Suggestions
Fix the broken "KEY PRINCIPLES" numbered list: items 4-10 currently sit after the "Molecular Matching Priority" section, splitting one list across two sections — either move items 4-10 up with items 1-3 or renumber them as a separate list.
Move the inline Critical Tool Parameters tables, Scoring Summary, and Known CIViC Gene IDs into TOOLS_REFERENCE.md and SCORING_CRITERIA.md, keeping only a brief pointer in SKILL.md, to remove duplication and shrink the context cost.
Integrate validation checkpoints into the phase workflow itself (e.g. after Phase 2 verify the merged NCT/CT/ISRCTN ID list is non-empty and deduplicated, and after Phase 3 confirm eligibility text was retrieved for each trial) rather than only in the separate Error Handling section.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and efficient — tables of tool parameters, point-scoring rubrics, and parallelization groups with no explanations of concepts Claude already knows. However, the Critical Tool Parameters tables, Scoring Summary, and hardcoded "Known CIViC Gene IDs" list duplicate material the Reference Files table assigns to TOOLS_REFERENCE.md and SCORING_CRITERIA.md, so not every token earns its place. Fits the 4 anchor (efficient, minor instances that could be trimmed) rather than 5. | 4 / 5 |
Actionability | Guidance is concrete and executable in spirit: exact tool names with required parameters ("action must be exactly 'search_studies'", "ALL 4 parameters... REQUIRED"), batch size of 10, a 0-100 scoring breakdown, and parallelization groups. It falls short of 5 because the body contains no worked search-query or code examples — those are deferred to EXAMPLES.md and TRIAL_SEARCH_PATTERNS.md, leaving minor gaps in copy-paste-ready guidance. | 4 / 5 |
Workflow Clarity | The ten phases are clearly sequenced with inputs/outputs per phase, parallelization groups, and an Error Handling section (try/except per call, empty-result checks, fallback tools, documented failures) that serves as validation for the batch operations, so it does not hit the batch-operation cap of 3. It is not 5 because checkpoints are described in a separate section rather than integrated as explicit per-phase validation steps, and the "KEY PRINCIPLES" list is structurally broken — items 4-10 are orphaned under the "Molecular Matching Priority" heading, interrupting the sequence. | 4 / 5 |
Progressive Disclosure | The body is an overview with a Reference Files table signaling seven one-level-deep references with their contents, which is good structure. It is not 5 because substantial reference material (the full tool parameter tables, CIViC gene ID lookup, detailed scoring tables) is inlined rather than split into those files, creating duplication, and none of the seven referenced files exist in the provided bundle to verify the links resolve. | 4 / 5 |
Total | 16 / 20 Passed |