<< All versions
Skill v1.0.1
currentTrusted Publisher100/100openai/plugins/gwas-catalog-skill
Refresh hyperframes branding (#186)
──Details
PublishedApril 26, 2026 at 08:51 PM
Content Hashsha256:15d19f8968a75aaa...
Git SHAb066e4a04761
──Files
Files (1 file, 2.5 KB)
SKILL.md2.5 KBactive
SKILL.md · 43 lines · 2.5 KB
version: "1.0.1" name: gwas-catalog-skill description: 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
Operating rules
- Use
scripts/rest_request.pyfor all GWAS Catalog API calls. - Use
base_url=https://www.ebi.ac.uk/gwas/rest/api/v2. - The script accepts
max_items; for collection endpoints, start with APIsize=10andmax_items=10. - Single-resource endpoints such as
studies/<accession>generally do not needmax_items. - Use
record_pathto target_embedded.<resource>lists. - Re-run requests in long conversations instead of relying on older tool output.
- Treat displayed
...in tool previews as UI truncation, not literal request content.
Execution behavior
- Return concise markdown summaries from the script JSON by default.
- Return the script JSON verbatim only if the user explicitly asks for machine-readable output.
- Prefer these paths:
metadata,studies,studies/<accession>,associations,snps,efoTraits,genes,publications, andloci. - Use
save_raw=trueif the user needs the full HATEOAS payload or pagination links.
Input
- Read one JSON object from stdin.
- Required fields:
base_url,path - Optional fields:
method,params,headers,json_body,form_body,record_path,response_format,max_items,max_depth,timeout_sec,save_raw,raw_output_path - Common GWAS Catalog patterns:
{"base_url":"https://www.ebi.ac.uk/gwas/rest/api/v2","path":"metadata"}{"base_url":"https://www.ebi.ac.uk/gwas/rest/api/v2","path":"studies","params":{"efo_trait":"asthma","size":10},"record_path":"_embedded.studies","max_items":10}{"base_url":"https://www.ebi.ac.uk/gwas/rest/api/v2","path":"associations","params":{"mapped_gene":"BRCA1","size":10},"record_path":"_embedded.associations","max_items":10}
Output
- Success returns
ok,source,path,method,status_code,warnings, and either compactrecordsor a compactsummary. - Use
raw_output_pathwhensave_raw=true. - Failure returns
ok=falsewitherror.codeanderror.message.
Execution
bash
echo '{"base_url":"https://www.ebi.ac.uk/gwas/rest/api/v2","path":"studies","params":{"efo_trait":"asthma","size":10},"record_path":"_embedded.studies","max_items":10}' | python scripts/rest_request.py
References
- No additional runtime references are required; keep the import package limited to this file and
scripts/rest_request.py.