Content
92%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, highly actionable skill body: complete input/output contracts, an executable example command, and correct delegation of implementation to bundle scripts. The only improvement space is minor tightening of the multiple example blocks in the Input section.
Suggestions
Merge the grch37 and rsid example objects into a single code block (or bullets) to trim the Input section.
Reduce the four separator examples to one or two representative forms since the allowed-separator list already states the rule.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and spec-like: operating rules, input forms, output shapes, and an executable invocation, with no explanation of concepts Claude already knows. Minor trimming is possible — the two 'Other accepted object forms' JSON blocks could be merged, and the four separator examples could be cut to two — which matches anchor 4 rather than the every-token-earns-its-place anchor of 5. | 4 / 5 |
Actionability | Fully executable guidance: a copy-paste-ready command ('echo '{"grch38":...}' | python scripts/gtex_eqtl.py'), concrete input schemas with real values, exact output shapes for success and failure, and the precise variantId format 'chr{chrom}_{pos}_{ref}_{alt}_b38'. It is not 4 because there are no gaps — the common invocation cases are all covered with real examples. | 5 / 5 |
Workflow Clarity | This is a simple single-task skill where the entire workflow is delegated to one entry-point script, and the single action is unambiguous: pass JSON on stdin, get one JSON object on stdout. Per the simple-skill exception, a single unambiguous action scores 5; the operation is non-destructive and non-batch, so the validation cap does not apply. | 5 / 5 |
Progressive Disclosure | The body is a concise interface document that points to the real entry-point 'scripts/gtex_eqtl.py', which exists in the bundle; the implementation (including scripts/variant_resolution.py, imported by the entry point) is appropriately split out of SKILL.md. Sections are well-organized and shallow with no nested references, so navigation is trivial. Not 4 because there is no misplaced or inline content that belongs in a separate file. | 5 / 5 |
Total | 19 / 20 Passed |