clinicaltrials-skill — Codex skill: what it does, how to install
This skill sends compact requests to the ClinicalTrials.gov API v2 and returns concise study summaries. Use it for study search and field inspection.
npx skills add openai/plugins --skill clinicaltrials-skill -a codexWhat clinicaltrials-skill does
clinicaltrials-skill uses scripts/clinicaltrials_client.py for ClinicalTrials.gov API v2 calls. It can search studies and return compact records, metadata, enum values, search areas, and field statistics. Search requests accept targeted params, while max_items and max_pages limit the result size.
Supported actions include studies, metadata, search_areas, enums, stats_size, field_values, field_sizes, and request. Set save_raw=true when you need a full or aggregated response; the result includes the saved file path. The script reads one JSON object from stdin with a required action field. Python and the script file are required.
Install it when your agent needs repeatable ClinicalTrials.gov searches or API field inspection. For one manual lookup, this skill adds more setup than you need.
What it helps with
- search studies by condition and status
- return concise clinical trial summaries
- inspect API metadata and search areas
- check field values and field sizes
- save a full API response to a file
Example prompts for the agent
- Find studies for `prostate cancer` with `RECRUITING` status and return the first 10 records.
- Show ClinicalTrials.gov API metadata and available search areas.
- Inspect `protocolSection.identificationModule.organization.fullName` and save the raw response.
How to install clinicaltrials-skill
1Skills CLI (Vercel)
npx skills add openai/plugins --skill clinicaltrials-skill -a codex2Manually: put the files in place
.agents/skills/clinicaltrials-skill/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add openai/plugins --skill clinicaltrials-skill -a claude-code2Manually: put the files in place
~/.claude/skills/clinicaltrials-skill/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/clinicaltrials-skill/
Manually: put the files in place
.cursor/skills/clinicaltrials-skill/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install openai/plugins clinicaltrials-skill2Manually: put the files in place
.github/skills/clinicaltrials-skill/SKILL.mdPlatform CLI
gemini skills install https://github.com/openai/plugins --path plugins/life-science-research/skills/clinicaltrials-skillManually: put the files in place
.devin/skills/clinicaltrials-skill/SKILL.mdThe legacy .windsurf/skills/ path still works
Claude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
From the same set201
The whole set →Similar
Questions about clinicaltrials-skill
How do I install clinicaltrials-skill in Codex?
Run npx skills add openai/plugins --skill clinicaltrials-skill -a codex. The skill file is placed at .agents/skills/clinicaltrials-skill/SKILL.md.
What does clinicaltrials-skill do?
It sends ClinicalTrials.gov API v2 requests through scripts/clinicaltrials_client.py and returns compact results for study search, metadata, and field analysis.
What does clinicaltrials-skill need to run?
It requires Python and scripts/clinicaltrials_client.py. The script receives one JSON object from stdin with a required action field.
