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 concise, actionable single-purpose skill body with clear sections and appropriate offloading of logic to bundled scripts. The main improvements are reducing redundancy in the input examples and making the error/validation flow explicit.
Suggestions
Consolidate the Input section's repeated JSON object examples into a single annotated example showing all accepted keys (grch38/grch37/rsid/variant/max_results) to trim tokens.
Add one or two executable shell examples for the rsID and GRCh37 input forms, mirroring the existing grch38 command, to push actionability to fully copy-paste-ready coverage.
State the validation/error-recovery flow explicitly (e.g. malformed input -> invalid_input; resolution failure -> network_error) instead of leaving it implicit in the script.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean, assumes Claude's competence, and avoids explaining what eQTL/GTEx are. It is not a 5 because the Input section repeats near-identical JSON object forms and separator examples that could be consolidated. | 4 / 5 |
Actionability | Provides a copy-paste runnable command, references the real entry script (scripts/gtex_eqtl.py), and gives concrete input/output JSON shapes. It is not a 5 because only one invocation form is shown as a shell command; rsID and GRCh37 invocations appear only as JSON, not as executable examples. | 4 / 5 |
Workflow Clarity | The Operating rules lay out a clear sequence (accept one input -> resolve to GRCh38 -> convert to variantId -> return one JSON object) and the skill is read-only, so the destructive/batch validation cap does not apply. It is not a 5 because validation/error-handling checkpoints are only implicit in the script rather than stated in the body. | 4 / 5 |
Progressive Disclosure | Well-organized sections (Operating rules, Input, Output, Execution) with a clear one-level-deep reference to the entry script; the implementation detail variant_resolution.py is correctly kept out of the overview, making navigation easy. | 5 / 5 |
Total | 17 / 20 Passed |