deepxiv-fa-trials
Skill843 starsChanged 8 months agoMITView on GitHub
Search all ~607k ClinicalTrials.gov studies by condition, phase, status, sponsor, country, with eligibility and biomarkers extracted. Use when a task needs clinical trials for a drug, disease or target.
- Installs packages
In this repository17 other files it gives its agents.
- deepxiv-baseline-tableSkill
- deepxiv-cliSkill
- deepxiv-fa-appraiseSkill
- deepxiv-fa-casesSkill
- deepxiv-fa-cveSkill
- deepxiv-fa-drugsSkill
- deepxiv-fa-filingsSkill
- deepxiv-fa-frSkill
- deepxiv-fa-grantsSkill
- deepxiv-fa-lawSkill
- deepxiv-fa-osvSkill
- deepxiv-fa-standardsSkill
- deepxiv-fa-stocksSkill
- deepxiv-fa-talentSkill
- deepxiv-fa-uk-eu-lawSkill
- deepxiv-fa-us-lawSkill
- deepxiv-trending-digestSkill
The file
We split this skill into the rules it gives an agent
1 rule. About 0 are common, 0 are distinctive, and 1 is very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈0
Distinctive · estimate
This author's own choices. Worth a look.
1
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Very specific: line 79
Always pass -d trials: automatic domain picking is still early.
≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
DeepXiv · Trials (trials)
All ~607k studies on ClinicalTrials.gov (one per NCT; Synced daily; exact counts are in corpus (live)). Phase / status / enrolment / countries / MeSH come from the ctgov record; eligibility highlights, biomarkers, prior therapy, ECOG and one-line summaries are model-extracted.
Corpus: 607,168 documents, updated 2026-10.
Setup
pip install -U deepxiv-sdk # deepxiv registers a token on first useWith a registered key (https://data.rag.ac.cn/register), search and read are fair use: 60/min, 5 at once, 5,000/day; on the auto-registered token they spend the deepxiv daily limit at the credits listed below. ask draws on the daily ask allowance (resets 00:00 UTC; a site-wide daily total can run out early at peak times), or 3 lifetime trial asks on the auto-registered token. On 429, back off for Retry-After seconds. Data goes to stdout; cost, quota and sources go to stderr. Exit 0 ok, 1 API error, 2 usage error. The general CLI guide is the deepxiv-cli skill.
Start here
deepxiv fa search trials "GLP-1 obesity" -F phase=PHASE3 -F overall_status=RECRUITING -k 5
deepxiv fa read trials NCT02082496 -l brief
deepxiv fa ask "recruiting phase 3 trials for pancreatic cancer" -d trialsFree samples: ids NCT02082496; queries glp-1 obesity phase 3.
Search
deepxiv fa search trials "query" [-F FILTER]... [-k N] [--offset N] [--mode M] [--head] [--json]Modes: hybrid, dense, bm25. Up to 100 hits. Cost 2 (with --head: 3).
An empty query is rejected; use "*" to list by filters only. Filters combine with AND; an undeclared field exits 2.
| filter | type | -F syntax | meaning |
phase | keyword | k=v, k=a,b | Trial phase Values: EARLY_PHASE1, PHASE1, PHASE2, PHASE3, PHASE4, NA. |
overall_status | keyword | k=v, k=a,b | Recruitment status Values: RECRUITING, NOT_YET_RECRUITING, ACTIVE_NOT_RECRUITING, ENROLLING_BY_INVITATION, COMPLETED, TERMINATED, WITHDRAWN, SUSPENDED …. |
study_type | keyword | k=v, k=a,b | Study type Values: INTERVENTIONAL, OBSERVATIONAL, EXPANDED_ACCESS. |
intervention_type | keyword | k=v, k=a,b | Intervention type Values: DRUG, BIOLOGICAL, DEVICE, PROCEDURE, BEHAVIORAL, DIAGNOSTIC_TEST, DIETARY_SUPPLEMENT, RADIATION …. |
condition_mesh | keyword | k=v, k=a,b | Condition MeSH term (controlled, more reliable than free-text conditions) |
countries | keyword | k=v, k=a,b | Trial countries |
start_year | integer | k=v, k>=n, k=n..m | Start year, range |
has_results | bool | k=v | Results posted |
sponsor_class | keyword | k=v, k=a,b | Sponsor class Values: INDUSTRY, NIH, FED, OTHER_GOV, NETWORK, INDIV, OTHER. |
Advanced filters (see deepxiv fa spec trials): sex, sponsor, intervention_mesh, biomarker_names, performance_status, treatment_naive, enrollment, age_min_years, age_max_years, completion_year.
Read
deepxiv fa read trials ID [ID...] [-l brief|detail|full] [-e EXTRA] [-p k=v]... [-f json|md|html]| level | credits | returns |
brief | 1 | Card: the fields needed to triage, same as in search hits |
detail (default) | 2 | Every structured field (rule-derived plus model-generated; model fields are listed in _enrich.fields) |
full | 5 | Full text (not available yet: the full registry record lives on NAS (ctgov/bulk) and is not in the index) |
At -l full, -p section=NAME reads one section and -p characters=N the first N characters.
Facets
deepxiv fa facets trials FIELD lists the legal values and counts, free. Use it instead of guessing a spelling. Fields: phase, overall_status, study_type, intervention_type, sponsor_class, sex, countries, condition_mesh.
Ask
deepxiv fa ask "question" -d trials [-e low|medium|high] [-p k=v]... [--no-stream] [--json]Agentic Q&A over this domain: the model turns the question into filters plus keywords from the domain's own self-description, reads the hits and answers with [trials:<nct_id> <title>] citations; /stream is NDJSON with real token deltas
Always pass -d trials: automatic domain picking is still early.
What this corpus will and will not tell you
- Filter by condition_mesh (controlled terms);
conditionsis free text as entered by the registrant. - Eligibility highlights, biomarkers, prior therapy and ECOG are model-extracted from the eligibility text — verify against the record before acting.
- 97k studies carry overall_status=UNKNOWN: the registrant stopped updating, which does not mean the trial ended.
- The index holds no full text: level=full is not available yet (the full registry record lives on NAS (ctgov/bulk) and is not in the index).
Citing
Cite records as [NCT02082496]. Say plainly when the corpus has nothing.
Generated by scripts/gen_fa_skills.py from deepxiv fa spec trials --json on 2026-10-19. Field names and prices can change; deepxiv fa spec trials is the live source.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.