Skip to main content
skill CX Codex

tooluniverse-clinical-trial-design — Claude Code skill: trial

The skill scores a clinical trial design across six dimensions and returns a feasibility report with enrollment projections.

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add mims-harvard/ToolUniverse --skill tooluniverse-clinical-trial-design -a claude-code
Open on GitHub

What tooluniverse-clinical-trial-design does

The skill assesses trial feasibility along six dimensions: endpoint, population, comparator, effect size, duration and regulatory pathway. Answers come from precedent trials and FDA guidance rather than first-principles math. Output is a [INDICATION]_trial_feasibility_report.md with 14 sections — a 0–100 feasibility score, enrollment projections, endpoint recommendations and an approval-pathway analysis.

Six research paths run in parallel: population sizing, biomarker prevalence and testing, comparator selection, endpoint selection, safety monitoring and regulatory pathway. Every claim gets an evidence grade from A to D, ranging from an FDA-approved endpoint in the same indication down to a proposal with no precedent. Before any tool runs, the skill asks four questions: what the primary endpoint is, who the population is, what the comparator is, and whether the effect size fits the mechanism.

Tool calls use English drug, disease and biomarker names even when you write in another language; the answer comes back in your language. Model invocation is disabled, so the skill behaves as a procedure over external tools. Checking standard of care needs DrugBank and FDA tools, and prevalence comes from OpenTargets, gnomAD or COSMIC — without those sources some paths stall.

What it helps with

  • judge whether a Phase 1/2 trial can actually enroll enough patients
  • pick a primary endpoint backed by precedent and FDA acceptance history
  • estimate biomarker prevalence and plan an enriched population
  • choose a comparator and decide whether placebo is defensible
  • map the regulatory route: 505(b)(1), 505(b)(2), orphan drug, fast track

Example prompts for the agent

  • assess trial feasibility for this indication and build the design report
  • pick an endpoint and comparator for a Phase 2 trial using precedent trials
  • project enrollment for a biomarker-enriched population

How to install tooluniverse-clinical-trial-design

1Skills CLI (Vercel)

npx skills add mims-harvard/ToolUniverse --skill tooluniverse-clinical-trial-design -a claude-code

2Manually: put the files in place

~/.claude/skills/tooluniverse-clinical-trial-design/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/tooluniverse-clinical-trial-design/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about tooluniverse-clinical-trial-design

How do I install tooluniverse-clinical-trial-design in Claude?

Run npx skills add mims-harvard/ToolUniverse --skill tooluniverse-clinical-trial-design -a claude-code. The skill file then lives at ~/.claude/skills/tooluniverse-clinical-trial-design/SKILL.md.

What does tooluniverse-clinical-trial-design do?

It analyzes a trial design across six dimensions and produces a feasibility report with enrollment projections, endpoint recommendations and approval-pathway analysis. The reasoning leans on precedent trials and FDA guidance.

Which platforms support the skill?

Besides Claude it installs into Codex, Cursor, GitHub Copilot, Gemini CLI and OpenCode, each with its own install command.

Source text

SKILL.md · Apache-2.0
---
name: tooluniverse-clinical-trial-design
description: Strategic clinical trial design feasibility assessment. Analyzes 6 dimensions (endpoint, population, comparator, effect size, duration, regulatory pathway) using precedent trials and FDA guidance. Produces enrollment projections, endpoint recommendations, and approval-pathway analysis. Use for trial-protocol design, power/sample-size estimation, comparator selection, and FDA submission strategy. Driven by precedent-based reasoning rather than first-principles math.
disable-model-invocation: true
---

# Clinical Trial Design Feasibility Assessment

Systematically assess clinical trial feasibility by analyzing 6 research dimensions. Produces comprehensive feasibility reports with quantitative enrollment projections, endpoint recommendations, and regulatory pathway analysis.

**IMPORTANT**: Always use English terms in tool calls (drug names, disease names, biomarker names), even if the user writes in another language. Only try original-language terms as a fallback if English returns no results. Respond in the user's language.

## Reasoning Before Searching

Trial design starts with the question, not the methods. Answer these four questions before running any tools — they determine everything else:

1. **What is the primary endpoint?** Is it overall survival (gold standard but slow), PFS (faster but surrogate), ORR (single-arm friendly but not always accepted), or a biomarker (needs validation as surrogate first)? The endpoint determines FDA pathway, statistical design, and duration.
2. **Who is the population?** Broad unselected vs. biomarker-enriched. Enriched populations have higher response rates, allowing smaller trials — but require a validated companion diagnostic and reduce the eligible patient pool.
3. **What is the comparator?** Placebo (only if no standard of care exists), active control (requires non-inferiority or superiority framing), or single-arm with historical control (acceptable for rare diseases or breakthrough designations, but FDA scrutiny is high).
4. **Is the effect size realistic given the mechanism?** A 20% improvement in ORR over SOC requires ~100 patients per arm. A 50% improvement requires ~30. If the mechanism only justifies a 10% improvement, the trial may be underpowered regardless of design. Check precedent effect sizes in similar trials before committing to an endpoint.

These four answers determine sample size, duration, and trial design. Look them up from precedent trials and FDA guidance — do not derive them from first principles.

**LOOK UP DON'T GUESS**: Never assume what the standard of care is for an indication — look it up with DrugBank and FDA tools. Never assume an endpoint is FDA-accepted — verify with `search_clinical_trials` precedents and `OpenFDA_get_approval_history`. Never estimate prevalence from memory — use OpenTargets, gnomAD, or COSMIC.

## Core Principles

### 1. Report-First Approach (MANDATORY)
**DO NOT** show tool outputs to user. Instead:
1. Create `[INDICATION]_trial_feasibility_report.md` FIRST
2. Initialize with all section headers
3. Progressively update as data arrives
4. Present only the final report

### 2. Evidence Grading System

| Grade | Symbol | Criteria | Examples |
|-------|--------|----------|----------|
| **A** | 3-star | Regulatory acceptance, multiple precedents | FDA-approved endpoint in same indication |
| **B** | 2-star | Clinical validation, single precedent | Phase 3 trial in related indication |
| **C** | 1-star | Preclinical or exploratory | Phase 1 use, biomarker validation ongoing |
| **D** | 0-star | Proposed, no validation | Novel endpoint, no precedent |

### 3. Feasibility Score (0-100)
Weighted composite score:
- **Patient Availability** (30%): Population size x biomarker prevalence x geography
- **Endpoint Precedent** (25%): Historical use, regulatory acceptance
- **Regulatory Clarity** (20%): Pathway defined, precedents exist
- **Comparator Feasibility** (15%): Standard of care availability
- **Safety Monitoring** (10%): Known risks, monitoring established

**Interpretation**: >=75 HIGH (proceed), 50-74 MODERATE (additional validation), <50 LOW (de-risking required)

---

## When to Use This Skill

Apply when users:
- Plan early-phase trials (Phase 1/2 emphasis)
- Need enrollment feasibility assessment
- Design biomarker-selected trials
- Evaluate endpoint strategies
- Assess regulatory pathways
- Compare trial design options
- Need safety monitoring plans

**Trigger phrases**: "clinical trial design", "trial feasibility", "enrollment projections", "endpoint selection", "trial planning", "Phase 1/2 design", "basket trial", "biomarker trial"

---

## Core Strategy: 6 Research Paths

Execute 6 parallel research dimensions. See `STUDY_DESIGN_PROCEDURES.md` for detailed steps per path.

```
Trial Design Query
|
+-- PATH 1: Patient Population Sizing
|   Disease prevalence, biomarker prevalence, geographic distribution,
|   eligibility criteria impact, enrollment projections
|
+-- PATH 2: Biomarker Prevalence & Testing
|   Mutation frequency, testing availability, turnaround time,
|   cost/reimbursement, alternative biomarkers
|
+-- PATH 3: Comparator Selection
|   Standard of care, approved comparators, historical controls,
|   placebo appropriateness, combination therapy
|
+-- PATH 4: Endpoint Selection
|   Primary endpoint precedents, FDA acceptance history,
|   measurement feasibility, surrogate vs clinical endpoints
|
+-- PATH 5: Safety Endpoints & Monitoring
|   Mechanism-based toxicity, class effects, organ-specific monitoring,
|   DLT history, safety monitoring plan
|
+-- PATH 6: Regulatory Pathway
    Regulatory precedents (505(b)(1), 505(b)(2)), breakthrough therapy,
    orphan drug, fast track, FDA guidance
```

---

## Report Structure (14 Sections)

Create `[INDICATION]_trial_feasibility_report.md` with all 14 sections. See `REPORT_TEMPLATE.md` for full templates with fillable fields.

1. **Executive Summary** - Feasibility score, key findings, go/no-go recommendation
2. **Disease Background** - Prevalence, incidence, SOC, unmet need
3. **Patient Population Analysis** - Base population, biomarker selection, eligibility funnel, enrollment projections
4. **Biomarker Strategy** - Primary biomarker, alternatives, testing logistics
5. **Endpoint Selection & Justification** - Primary/secondary/exploratory endpoints, statistical considerations
6. **Comparator Analysis** - SOC, trial design options (single-arm vs randomized vs non-inferiority), drug sourcing
7. **Safety Endpoints & Monitoring Plan** - DLT definition, mechanism-based toxicities, organ monitoring, SMC
8. **Study Design Recommendations** - Phase, design type, schema, eligibility, treatment plan, assessment schedule
9. **Enrollment & Site Strategy** - Site selection, enrollment projections, recruitment strategies
10. **Regulatory Pathway** - FDA pathway, precedents, pre-IND meeting, IND timeline
11. **Budget & Resource Considerations** - Cost drivers, timeline, FTE requirements
12. **Risk Assessment** - Feasibility risks, scientific risks, mitigation strategies
13. **Success Criteria & Go/No-Go Decision** - Phase 1/2 criteria, interim analysis, feasibility scorecard
14. **Recommendations & Next Steps** - Final recommendation, critical path to IND, alternative designs

---

## Tool Reference by Research Path

### PATH 1: Patient Population Sizing
- `OpenTargets_get_disease_id_description_by_name` - Disease lookup
- `OpenTargets_get_diseases_phenotypes_by_target_ensembl` - Prevalence data
- `ClinVar_search_variants` - Biomarker mutation frequency
- `gnomad_search_variants` - Population allele frequencies
- `PubMed_search_articles` - Epidemiology literature
- `search_clinical_trials` - Enrollment feasibility from past trials

### PATH 2: Biomarker Prevalence & Testing
- `ClinVar_get_variant_details` - Variant pathogenicity
- `COSMIC_search_mutations` - Cancer-specific mutation frequencies
- `gnomad_get_variant` - Population genetics
- `PubMed_search_articles` - CDx test performance, guidelines

### PATH 3: Comparator Selection
- `drugbank_get_drug_basic_info_by_drug_name_or_id` - Drug info
- `drugbank_get_indications_by_drug_name_or_drugbank_id` - Approved indications
- `drugbank_get_pharmacology_by_drug_name_or_drugbank_id` - Mechanism
- `FDA_OrangeBook_search_drug` - Generic availability
- `OpenFDA_get_approval_history` - Approval details
- `search_clinical_trials` - Historical control data

### PATH 4: Endpoint Selection
- `search_clinical_trials` - Precedent trials, endpoints used
- `PubMed_search_articles` - FDA acceptance history, endpoint validation
- `OpenFDA_get_approval_history` - Approved endpoints by indication

### PATH 5: Safety Endpoints & Monitoring
- `drugbank_get_pharmacology_by_drug_name_or_drugbank_id` - Mechanism toxicity
- `FDA_get_warnings_and_cautions_by_drug_name` - FDA black box warnings
- `FAERS_search_reports_by_drug_and_reaction` - Real-world adverse events
- `FAERS_count_reactions_by_drug_event` - AE frequency
- `FAERS_count_death_related_by_drug` - Serious outcomes
- `PubMed_search_articles` - DLT definitions, monitoring strategies

### PATH 6: Regulatory Pathway
- `OpenFDA_get_approval_history` - Precedent approvals
- `PubMed_search_articles` - Breakthrough designations, FDA guidance
- `search_clinical_trials` - Regulatory precedents (accelerated approval)

---

## Quick Start Example

```python
from tooluniverse import ToolUniverse

tu = ToolUniverse()
tu.load_tools()

# Example: EGFR+ NSCLC trial feasibility
# Step 1: Disease prevalence
disease_info = tu.tools.OpenTargets_get_disease_id_description_by_name(
    diseaseName="non-small cell lung cancer"
)
# Returns HPO phenotypes only, not prevalence figures; get prevalence from literature
prevalence = tu.tools.OpenTargets_get_associated_phenotypes_by_disease_efoId(
    efoId=disease_info['data']['search']['hits'][0]['id']
)

# Step 2: Biomarker prevalence
variants = tu.tools.ClinVar_search_variants(gene="EGFR", significance="pathogenic")

# Step 3: Precedent trials
trials = tu.tools.ClinicalTrials_search_studies(
    condition="EGFR positive non-small cell lung cancer",
    filter_status="COMPLETED", filter_phase="PHASE2"
)

# Step 4: Standard of care comparator
soc = tu.tools.FDA_OrangeBook_search_drug(generic_name="osimertinib")

# Compile into feasibility report...
```

See `WORKFLOW_DETAILS.md` for the complete 6-path Python workflow and use case examples.

---

## Next Steps

Once this feasibility assessment is complete, use **`tooluniverse-clinical-trial-protocol`** to turn the 6-dimension findings (endpoint, population, comparator, effect size, duration, regulatory pathway) into an actual protocol document — full ICH E6(R2)/FDA-style sections plus a real sample-size calculation. That skill consumes this report's output rather than re-deriving feasibility.

## Integration with Other Skills

- **tooluniverse-drug-research**: Investigate mechanism, preclinical data
- **tooluniverse-disease-research**: Deep dive on disease biology
- **tooluniverse-target-research**: Validate drug target, essentiality
- **tooluniverse-pharmacovigilance**: Post-market safety for comparator drugs
- **tooluniverse-precision-oncology**: Biomarker biology, resistance mechanisms

---

## Programmatic Access (Beyond Tools)

When ToolUniverse tools return limited trial metadata, use the ClinicalTrials.gov v2 API directly:

```python
import requests, pandas as pd

# Search with pagination (all lung cancer immunotherapy trials with results)
all_studies = []
token = None
while True:
    params = {"query.cond": "lung cancer", "query.intr": "immunotherapy",
              "filter.overallStatus": "COMPLETED", "filter.results": "WITH_RESULTS", "pageSize": 100}
    if token: params["pageToken"] = token
    resp = requests.get("https://clinicaltrials.gov/api/v2/studies", params=params).json()
    all_studies.extend(resp.get("studies", []))
    token = resp.get("nextPageToken")
    if not token: break

# Extract structured data
rows = []
for s in all_studies:
    proto = s.get("protocolSection", {})
    rows.append({
        "nctId": proto.get("identificationModule", {}).get("nctId"),
        "title": proto.get("identificationModule", {}).get("briefTitle"),
        "enrollment": proto.get("designModule", {}).get("enrollmentInfo", {}).get("count"),
        "phase": proto.get("designModule", {}).get("phases", [None])[0] if proto.get("designModule", {}).get("phases") else None,
    })
df = pd.DataFrame(rows)

# FDA drug approval history
drug = "pembrolizumab"
fda = requests.get(f"https://api.fda.gov/drug/drugsfda.json?search=openfda.brand_name:{drug}&limit=10").json()
```

See `tooluniverse-data-wrangling` skill for pagination, error handling, and bulk download patterns.

---

## Reference Files

| File | Content |
|------|---------|
| `REPORT_TEMPLATE.md` | Full 14-section report template with fillable fields |
| `STUDY_DESIGN_PROCEDURES.md` | Detailed steps for each of the 6 research paths |
| `WORKFLOW_DETAILS.md` | Complete Python example workflow and 5 use case summaries |
| `BEST_PRACTICES.md` | Best practices, common pitfalls, output format requirements |
| `EXAMPLES.md` | Additional examples |
| `QUICK_START.md` | Quick start guide |

---

## Version Information

- **Version**: 1.0.0
- **Last Updated**: February 2026
- **Compatible with**: ToolUniverse 0.5+
- **Focus**: Phase 1/2 early clinical development

© mims-harvard · Apache-2.0 · mims-harvard/ToolUniverse

Similar skills

Everything for Science and research →

From the same set55

tooluniverse-literature-deep-research A skill for deep literature search across PubMed, EuropePMC and bioRxiv, with citation networks and evidence grading. Useful when you need a review with citations. CX Codex +1 664installs tooluniverse-image-analysis Automates microscopy and quantitative imaging analysis from ImageJ or CellProfiler tables. Handles colony morphometry, Dunnett's tests, and dose-response curves. CX Codex +1 653installs tooluniverse-clinical-guidelines A skill that pulls clinical practice guidelines from NICE, WHO, NCCN, AHA, ADA and more, then ranks them by source authority. CX Codex +1 491installs tooluniverse Routes biomedical research queries to specialized skills and extracts authoritative cell outputs from executed notebooks. CX Codex +1 479installs tooluniverse-drug-drug-interaction Works through drug-drug interactions: mechanism, severity, a 0–100 risk score and what to do about the prescription. Built for polypharmacy reviews. CX Codex +1 452installs tooluniverse-disease-research Builds a cited disease report covering genetics, pathways, drugs and clinical trials. Handy for rare-disease profiles where memory is not enough. CX Codex +1 437installs tooluniverse-systems-biology A skill for pathway and systems biology work: enrichment on a gene list, protein-to-pathway mapping, SBML model search. Useful when you have RNA-seq or proteomics hits. CX Codex +1 433installs tooluniverse-protein-structure-retrieval Retrieves and evaluates protein structures across RCSB PDB, PDBe, AlphaFold, and SWISS-MODEL. Helps select experimental or predicted models for modeling. CX Codex +1 433installs

Project sponsors

Companies that keep this analytics open
Gold sponsor

Impressions, clicks and code copies — open statistics. We keep the numbers public for the same reason NeBlask itself is public. Become a sponsor