Content
65%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
Highly actionable with executable examples and precise tool reference, but the single monolithic file could offload detail to bundle files and the showcased workflows lack validation feedback between steps.
Suggestions
Move the duplicated Tool Quick Reference table and/or the Programmatic Access GDC-API bulk code into a reference bundle file, keeping SKILL.md as an overview with one-level-deep links, to improve progressive disclosure and remove redundancy.
Add explicit validation/feedback steps to the example workflows (e.g., check the returned status field, handle empty data by re-confirming project_id, retry on truncation) so multi-step sequences have checkpoints.
Trim or fold the Synthesis Questions and advisory Reasoning Framework prose into the tool sections where they apply, reducing tokens that don't directly drive action.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Most content earns its place (tool signatures and return shapes Claude cannot know), but the Tool Quick Reference table duplicates the per-phase tool detail and the Synthesis Questions section is advisory padding. It is not 3 because of this redundancy, and not 1 because there is no concept-padding Claude already knows. | 2 / 3 |
Actionability | Provides multiple complete, executable Python blocks (clinical data, mutations, CNV, survival, OncoKB) plus concrete parameter signatures and return-shape specs that are copy-paste ready. It is not 2 because the examples are real executable code rather than pseudocode. | 3 / 3 |
Workflow Clarity | A clear 6-phase overview and explicit checkpoints (cohort-first, 'LOOK UP DON'T GUESS', pagination break-loop) exist, but the showcased example workflows (Workflow 1-3) are linear with no validation or feedback between steps. It is not 3 because error-recovery feedback loops between workflow steps are absent; not 1 because the sequence and some checkpoints are present. | 2 / 3 |
Progressive Disclosure | Sections are well-organized, but the skill is a monolithic 328-line single file with no bundle-file references, and content that could be split (Programmatic Access GDC API bulk code, Reasoning Framework) is inline. It is not 3 because nothing is split into one-level-deep references; not 1 because organization is good, not a wall of text. | 2 / 3 |
Total | 9 / 12 Passed |