CtrlK
BlogDocsLog inGet started
Tessl Logo

adaptive-trial-simulator

Design and simulate adaptive clinical trials with interim analyses, sample size re-estimation, and early stopping rules. Evaluate Type I error control, power, and expected sample size via Monte Carlo simulation before trial initiation.

68

7.30x
Quality

60%

Does it follow best practices?

Impact

73%

7.30x

Average score across 3 eval scenarios

SecuritybySnyk

Passed

No known issues

Optimize this skill with Tessl

npx tessl skill review --optimize ./scientific-skills/Evidence insights/adaptive-trial-simulator/SKILL.md
SKILL.md
Quality
Evals
Security

Adaptive Trial Simulator

Statistical simulation platform for designing and validating adaptive clinical trial designs in silico. Enables optimization of interim analysis strategies, sample size adaptation, and early stopping rules while maintaining Type I error control.

Features

  • Design Simulation: Monte Carlo validation of adaptive designs
  • Sample Size Re-estimation: Adapt sample size based on interim data
  • Early Stopping Rules: Futility and efficacy boundary optimization
  • Type I Error Control: Validate alpha spending strategies
  • Multi-Arm Designs: Drop-the-loser and seamless Phase II/III
  • Power Optimization: Identify designs with maximum power efficiency

Usage

Basic Usage

# Run standard group sequential design
python scripts/main.py

# Adaptive design with sample size re-estimation
python scripts/main.py --design adaptive_reestimate

# Optimize design parameters
python scripts/main.py --optimize

Parameters

ParameterTypeDefaultRequiredDescription
--designstrgroup_sequentialNoTrial design type
--n-simulationsint10000NoNumber of Monte Carlo simulations
--sample-sizeint200NoInitial sample size per arm
--effect-sizefloat0.3NoEffect size (Cohen's d)
--alphafloat0.05NoType I error rate
--powerfloat0.80NoTarget statistical power
--interim-looksint1NoNumber of interim analyses
--spending-functionstrobrien_flemingNoAlpha spending function
--reestimate-methodstrpromising_zoneNoSample size re-estimation method
--outputstrresults.jsonNoOutput file path
--visualizeflagFalseNoGenerate visualization charts
--optimizeflagFalseNoSearch for optimal design parameters

Advanced Usage

# Full adaptive design with visualization
python scripts/main.py \
  --design adaptive_reestimate \
  --n-simulations 50000 \
  --sample-size 250 \
  --effect-size 0.35 \
  --interim-looks 2 \
  --spending-function obrien_fleming \
  --visualize \
  --output adaptive_results.json

Design Types

Design TypeDescriptionUse Case
Group SequentialFixed interim looks with stopping boundariesStandard adaptive trials
Adaptive Re-estimateSample size adjustment based on interim dataUncertain effect size
Drop the LoserMulti-arm trials dropping inferior armsPhase II dose selection

Spending Functions

FunctionCharacteristicsEarly Boundary
O'Brien-FlemingConservative earlyHigh Z-scores early
PocockAggressive earlyLower Z-scores throughout
Power FamilyModerate (ρ=3)Balanced approach

Output Example

{
  "design_config": {
    "design_type": "adaptive_reestimate",
    "sample_size_per_arm": 200,
    "effect_size": 0.3,
    "alpha": 0.05,
    "target_power": 0.8
  },
  "simulation_results": {
    "power": 0.8234,
    "type_i_error": 0.0481,
    "expected_sample_size": 385.2,
    "early_stop_rate": {
      "efficacy": 0.1523,
      "futility": 0.0841
    }
  }
}

Technical Difficulty: HIGH

⚠️ AI自主验收状态: 需人工检查

This skill requires:

  • Python 3.8+ environment
  • NumPy, SciPy, and Matplotlib packages
  • Understanding of clinical trial statistics

Dependencies

pip install -r requirements.txt

Requirements

numpy>=1.20.0
scipy>=1.7.0
matplotlib>=3.4.0

Risk Assessment

Risk IndicatorAssessmentLevel
Code ExecutionPython scripts with mathematical calculationsMedium
Network AccessNo network accessLow
File System AccessWrites simulation resultsLow
Instruction TamperingStatistical parameters could affect resultsMedium
Data ExposureNo sensitive data exposureLow

Security Checklist

  • No hardcoded credentials or API keys
  • No unauthorized file system access
  • Output does not expose sensitive information
  • Input parameters validated
  • Error messages sanitized
  • Dependencies audited

Prerequisites

pip install -r requirements.txt
python scripts/main.py --help

Evaluation Criteria

Success Metrics

  • Simulations run without errors
  • Type I error controlled at nominal level
  • Power estimates are accurate
  • Visualizations generated correctly

Test Cases

  1. Basic Simulation: Default parameters → Valid results
  2. Different Designs: All design types → Appropriate behavior
  3. Optimization Mode: --optimize flag → Finds optimal parameters
  4. Visualization: --visualize flag → Charts generated

Lifecycle Status

  • Current Stage: Draft
  • Next Review Date: 2026-03-15
  • Known Issues: Type checking warnings with numpy arrays
  • Planned Improvements:
    • Bayesian adaptive designs
    • Multi-arm multi-stage (MAMS) support
    • Enhanced visualization options

References

Available in references/:

  • Adaptive design statistical theory
  • Regulatory guidance documents
  • Alpha spending function literature
  • Sample size re-estimation methods

Limitations

  • Statistical Complexity: Requires biostatistics expertise
  • Simulation Time: Large simulations may take hours
  • Simplified Models: Does not capture all real-world complexities
  • Regulatory Consultation: Results should be validated with regulators

⚠️ DISCLAIMER: This tool provides simulation results for research and planning purposes only. All clinical trial designs should be reviewed by qualified biostatisticians and regulatory experts before implementation.

Repository
aipoch/medical-research-skills
Last updated
Created

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.