Trialgpt matching
Skill FridrichMethod/awesome-skills/skills/trialgpt-matching
Trial shortlistFrom its SKILL.md
npx -y skills add FridrichMethod/awesome-skills --skill trialgpt-matchingAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
2 things to look at
- no licenseNo license file was found in the repository. Code published without one is not open source by default, so using it at work is a question for whoever answers licensing questions where you are.
- 13 stars13 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.
What its file declares
Copied from the file, not written here
The file declares its own license as MIT. That is the author’s claim about this one file, and it is not the same thing as the license GitHub reports for the repository, which is listed with the other numbers below.
SKILL.md
2.3 KB, 439 tokens by cl100k_base, as published. Nobody here has run it
TrialGPT Matching
Run the locally checked-out TrialGPT pipeline to retrieve, rank, and explain candidate trials for a patient before deeper eligibility review.
Inputs
- Patient summary (structured JSON or free text) with condition keywords.
- Optional filters: geography, phase, intervention, biomarker.
- Up-to-date ClinicalTrials.gov dump or API access.
Outputs
- Ranked trial table with NCT ID, title, score, and short justification.
- Parsed inclusion/exclusion text ready for downstream eligibility agents.
- Missing data checklist (e.g., "ECOG not provided").
Workflow
- Setup:
cd repo && pip install -r requirements.txt(or reuse env). - Trial retrieval: Run TrialGPT retriever to pull candidate trials for the indication.
- Criteria parsing: Convert eligibility blocks to structured criteria JSON.
- Patient profiling: Summarize patient facts (labs, prior therapies, biomarkers).
- Ranking: Execute TrialGPT ranking script to score each trial and emit explanations.
- Handoff: Export ranked list + structured criteria for
trial-eligibility-agent.
Guardrails
- Refresh ClinicalTrials.gov metadata regularly to avoid stale trials.
- Label scores as AI-generated suggestions pending clinician validation.
- Retain prompt/config metadata for audit trails.
References
- Detailed usage instructions and repo layout live in
README.md. - Coordinate with
Skills/Clinical/Trial_Eligibility_Agentfor criterion-level review.
What ships with it: 12 files
41.7 KB alongside SKILL.md, 8 of them executable
repo/
- LICENSE1.2 KB
- README.md11.3 KB
- requirements.txt211 B
- results/__init__.pyruns402 B
- trialgpt_matching/run_matching.pyruns2.0 KB
- trialgpt_matching/TrialGPT.pyruns6.1 KB
- trialgpt_ranking/rank_results.pyruns2.9 KB
- trialgpt_ranking/run_aggregation.pyruns2.4 KB
- trialgpt_ranking/TrialGPT.pyruns4.6 KB
- trialgpt_retrieval/hybrid_fusion_retrieval.pyruns6.5 KB
- trialgpt_retrieval/keyword_generation.pyruns2.0 KB
- README.md2.1 KB