CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

gwas-catalog-skill

Submit compact GWAS Catalog REST API v2 requests for studies, associations, SNPs, EFO traits, genes, publications, loci, and metadata. Use when a user wants concise GWAS Catalog summaries

70

Quality

88%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

SKILL.md
Quality
Evals
Security

Quality

Content

92%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

The body is an exemplary compact skill: executable examples, exact endpoints and parameters, clear input/output contracts, and honest minimal bundling. The only improvement is trimming one or two rules that re-state what Claude already knows or what the script itself documents.

DimensionReasoningScore

Conciseness

The body is lean, bullet-structured, and assumes Claude's competence (no explanation of what REST or JSON is), but contains minor instances that could be trimmed: the rule "Treat displayed `...` in tool previews as UI truncation, not literal request content" explains something Claude broadly already knows, and the Input section enumerates twelve optional fields that largely restate the script's own interface documentation. Not a 5 ('every token earns its place') because of those small redundancies; well above a 3 ('some unnecessary explanation').

4 / 5

Actionability

Fully executable and copy-paste ready: an exact base_url, an explicit path list ("metadata", "studies", "studies/<accession>", "associations", "snps", "efoTraits"...), three concrete request JSON examples covering common cases, and a runnable bash one-liner piping stdin to `python scripts/rest_request.py`. This matches the 5 anchor ('copy-paste ready code or commands; specific examples cover the common cases').

5 / 5

Workflow Clarity

This is a simple, single-task skill (under 50 lines) whose one action — construct a JSON request, pipe it to the script, return a concise summary — is unambiguous, so the simple-skill exception applies. All decision points are addressed: when to use max_items ("for collection endpoints, start with API size=10"), record_path targeting ("_embedded.<resource>"), output defaults ("concise markdown summaries... by default"), and failure behavior ("ok=false with error.code and error.message"). No destructive or batch operations exist that would cap the score.

5 / 5

Progressive Disclosure

Per the rubric's guideline for skills under 50 lines with no need for external references, well-organized sections alone earn a 5: the ~37-line body is cleanly sectioned (Operating rules, Execution behavior, Input, Output, Execution, References), and the single bundle file it cites (`scripts/rest_request.py`) exists in the bundle and matches the documented interface. The References section explicitly and honestly declares that no additional runtime references are required.

5 / 5

Total

19

/

20

Passed

Description

78%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong, third-person description that names a concrete capability and an explicit 'Use when' clause for a well-defined niche. Its main weakness is a single narrow trigger phrase and the absence of common synonyms (notably bare 'GWAS', 'genome-wide association', 'variants').

Suggestions

Broaden the trigger clause to mirror the resource list, e.g. "Use when a user asks about GWAS Catalog studies, associations, SNPs, genes, EFO traits, or publications, or wants concise GWAS Catalog summaries."

Add common synonyms users naturally say — "GWAS", "genome-wide association", "genetic variants/traits" — to improve keyword coverage for discovery.

Name a second concrete action beyond 'submit requests', such as summarizing or filtering records, to strengthen capability specificity.

DimensionReasoningScore

Specificity

The description gives a concrete action ("Submit compact GWAS Catalog REST API v2 requests") with a comprehensive list of resources ("studies, associations, SNPs, EFO traits, genes, publications, loci, and metadata"), but hinges on a single action verb rather than the multiple distinct concrete actions of the 5 anchor (e.g. "Extract text and tables... fill forms, merge documents, convert pages to images"). It is clearly above the 3 anchor's '1-2 concrete actions, not comprehensive' because the resource coverage is thorough.

4 / 5

Completeness

Both parts are explicit: what ("Submit compact GWAS Catalog REST API v2 requests for studies, associations, SNPs...") and when ("Use when a user wants concise GWAS Catalog summaries"). Not a 5 because the trigger clause is a single narrow condition ('concise summaries') that undersells the breadth of the what-clause (requesting any of eight resource types), whereas the 5 anchor gives multiple concrete trigger phrases; not a 3 because 'when' is explicitly present, not merely implied.

4 / 5

Trigger Term Quality

Natural domain terms users would say appear directly: "GWAS Catalog", "SNPs", "genes", "associations", "studies", "summaries". Missing common variations and synonyms — "GWAS" alone (without "Catalog"), "genome-wide association", "variants", "genetic traits" — so it falls short of the 5 anchor's 'comprehensive coverage including synonyms'. It is well above the 3 anchor ('some relevant keywords but missing common variations') because several natural user phrasings are covered.

4 / 5

Distinctiveness Conflict Risk

"GWAS Catalog" is a clear niche with distinct, unambiguous triggers (GWAS Catalog, EFO traits, specific REST API v2 endpoints); overlap with other skills is minimal, matching the 5 anchor ('clear niche with distinct triggers; minimal conflict risk').

5 / 5

Total

17

/

20

Passed

Validation

100%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

openai/plugins

Path

plugins/life-science-research/skills/gwas-catalog-skill/SKILL.md

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.