eqtl-catalogue-skill — Codex skill for eQTL Catalogue queries
Query the public eQTL Catalogue API for associations and documented metadata, then get a concise summary. Useful for focused eQTL research.
npx skills add openai/plugins --skill eqtl-catalogue-skill -a codexWhat eqtl-catalogue-skill does
This skill sends requests to the eQTL Catalogue API through scripts/rest_request.py. It targets association lookups and documented metadata endpoints, favouring filtered queries over broad lists. By default, the agent turns the script’s JSON response into a short Markdown summary; raw JSON is returned when explicitly requested.
Requests use an API address and a path. Examples cover study listings and association searches using gene_id, rsid, or variant_id; the script also supplies compatibility parameters for association calls. The public API has returned 400 and 500 errors and timed out with documented parameters, so upstream failures can interrupt a query. The skill is listed for Codex and ChatGPT.
What it helps with
- look up associations for a gene and variant
- browse studies in the catalogue
- summarize an API response in Markdown
- retrieve data from documented metadata endpoints
Example prompts for the agent
- Find associations for gene
ENSG00000141510and variantrs7903146. - Show a few entries from the eQTL Catalogue study list.
- Summarize the association results for
rs7903146.
How to install eqtl-catalogue-skill
1Skills CLI (Vercel)
npx skills add openai/plugins --skill eqtl-catalogue-skill -a codex2Manually: put the files in place
.agents/skills/eqtl-catalogue-skill/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add openai/plugins --skill eqtl-catalogue-skill -a claude-code2Manually: put the files in place
~/.claude/skills/eqtl-catalogue-skill/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/eqtl-catalogue-skill/
Manually: put the files in place
.cursor/skills/eqtl-catalogue-skill/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install openai/plugins eqtl-catalogue-skill2Manually: put the files in place
.github/skills/eqtl-catalogue-skill/SKILL.mdPlatform CLI
gemini skills install https://github.com/openai/plugins --path plugins/life-science-research/skills/eqtl-catalogue-skillManually: put the files in place
.devin/skills/eqtl-catalogue-skill/SKILL.mdThe legacy .windsurf/skills/ path still works
Claude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: Codex skills: how to install, where they live, how to call them
Questions about eqtl-catalogue-skill
How do I install eqtl-catalogue-skill in Codex?
Run npx skills add openai/plugins --skill eqtl-catalogue-skill. To name the agent explicitly, run npx skills add openai/plugins --skill eqtl-catalogue-skill -a codex.
What does eqtl-catalogue-skill do?
It queries the eQTL Catalogue API for associations and data from documented metadata endpoints. The default response is a concise Markdown summary.
Why might an eQTL Catalogue request fail?
The public API has returned 400 and 500 errors or timed out, including with documented parameters. The skill passes upstream errors through.