Content
93%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 tight, highly actionable single-purpose skill with executable examples and well-organized sections that leverage the bundled script appropriately. The only gap is the absence of an explicit validation/error-recovery loop for batch collection requests.
Suggestions
Add an explicit error-handling checkpoint, e.g. 'If ok=false, inspect error.code (network_error/invalid_input/invalid_response), adjust the request, and re-run' to support recovery on batch endpoints.
For collection endpoints with pageSize/max_items, note how to confirm truncation (record_count_available > record_count_returned) and page further when the user needs more.
Optionally show the success-output shape inline with a one-line compact example so Claude can map summary vs records fields without a round trip.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and rule-driven with no padding or explanation of concepts Claude already knows; every line (base_url, pageSize guidance, POST+json_body, Accept header) earns its place. | 5 / 5 |
Actionability | It provides executable, copy-paste-ready examples in the Execution section plus two concrete cBioPortal request JSON patterns, covering the common study-list and mutation-fetch cases. | 5 / 5 |
Workflow Clarity | Operating rules, execution behavior, input, output, and a worked command are clearly sequenced, but there is no explicit validation/error-recovery checkpoint for failed or batch requests despite batch collection endpoints. | 4 / 5 |
Progressive Disclosure | The skill is well under 50 lines, single-purpose, and correctly confines bulk logic to the bundled scripts/rest_request.py while keeping SKILL.md as a concise overview with clear section organization. | 5 / 5 |
Total | 19 / 20 Passed |