← Back to Skills Marketplace
aipoch-ai

Adaptive Trial Simulator

by AIpoch · GitHub ↗ · v0.1.0 · MIT-0
cross-platform ✓ Security Clean
201
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install adaptive-trial-simulator
Description
Design and simulate adaptive clinical trials with interim analyses, sample size re-estimation, and early stopping rules. Evaluate Type I error control, power...
README (SKILL.md)

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

Parameter Type Default Required Description
--design str group_sequential No Trial design type
--n-simulations int 10000 No Number of Monte Carlo simulations
--sample-size int 200 No Initial sample size per arm
--effect-size float 0.3 No Effect size (Cohen's d)
--alpha float 0.05 No Type I error rate
--power float 0.80 No Target statistical power
--interim-looks int 1 No Number of interim analyses
--spending-function str obrien_fleming No Alpha spending function
--reestimate-method str promising_zone No Sample size re-estimation method
--output str results.json No Output file path
--visualize flag False No Generate visualization charts
--optimize flag False No Search 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 Type Description Use Case
Group Sequential Fixed interim looks with stopping boundaries Standard adaptive trials
Adaptive Re-estimate Sample size adjustment based on interim data Uncertain effect size
Drop the Loser Multi-arm trials dropping inferior arms Phase II dose selection

Spending Functions

Function Characteristics Early Boundary
O'Brien-Fleming Conservative early High Z-scores early
Pocock Aggressive early Lower Z-scores throughout
Power Family Moderate (ρ=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 Indicator Assessment Level
Code Execution Python scripts with mathematical calculations Medium
Network Access No network access Low
File System Access Writes simulation results Low
Instruction Tampering Statistical parameters could affect results Medium
Data Exposure No sensitive data exposure Low

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.

Usage Guidance
This skill appears to implement what it claims (a Monte Carlo adaptive trial simulator) and does not request secrets or system privileges. Before running: (1) inspect the entire scripts/main.py (search for network modules like requests/urllib/socket, subprocess/exec/eval, os.environ access, or obfuscated strings) since the provided listing was truncated; (2) run it in a sandbox or isolated environment first (container/VM); (3) pin or audit dependencies you install (numpy/scipy/matplotlib) to avoid supply‑chain surprises; (4) avoid feeding or storing real patient/PHI data with this tool unless you perform a privacy/security review; (5) for reproducibility and safety, run with small n_simulations first and check outputs. If you want, I can scan the rest of scripts/main.py (full file) for hidden network calls or credential access.
Capability Analysis
Type: OpenClaw Skill Name: adaptive-trial-simulator Version: 0.1.0 The adaptive-trial-simulator bundle is a legitimate statistical tool for clinical trial design simulation. The core logic in scripts/main.py uses standard scientific libraries (numpy, scipy) to perform Monte Carlo simulations, interim analyses, and sample size re-estimation without any evidence of network access, data exfiltration, or unauthorized file system interaction. The SKILL.md documentation is well-structured and contains no prompt injection attempts or instructions to perform hidden or harmful actions.
Capability Assessment
Purpose & Capability
Name/description (adaptive clinical trial simulator) match the provided artifacts: SKILL.md documents simulation parameters and the included scripts/main.py implements sampling, alpha spending, conditional power, and sample‑size reestimation. No unrelated credentials, binaries, or config paths are requested.
Instruction Scope
SKILL.md tells the agent to run the included Python script with simulation flags; the instructions do not ask for reading unrelated files, environment variables, or network endpoints. The README claims 'No network access' and the visible portion of main.py contains only local numeric computations and file output. However the provided main.py content was truncated in this package listing, so the tail of the script (where unexpected behavior could appear) was not visible to me.
Install Mechanism
No install spec; it's instruction‑only plus a Python script. Dependencies are standard scientific packages (numpy, scipy, matplotlib) declared in requirements.txt — no remote/executable downloads or custom install scripts detected.
Credentials
The skill requests no environment variables, credentials, or config paths. Declared dependencies and runtime needs (Python 3.8+, NumPy/SciPy/Matplotlib) are proportionate to a statistical simulation tool.
Persistence & Privilege
The skill does not request always: true and does not modify agent/system configuration. It runs as a local script and writes simulation results (expected behaviour). No elevated persistence or cross‑skill config access is present in visible files.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install adaptive-trial-simulator
  3. After installation, invoke the skill by name or use /adaptive-trial-simulator
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v0.1.0
- Initial release of the adaptive-trial-simulator skill. - Enables design and Monte Carlo simulation of adaptive clinical trials with interim analyses, sample size re-estimation, and early stopping rules. - Supports multiple adaptive design strategies, including group sequential, sample size re-estimation, and drop-the-loser multi-arm designs. - Validates Type I error control, power, and expected sample size for user-specified designs. - Command-line usage supports parameter customization, design optimization, and visualization of results. - Focused on statistical simulation; outputs results in JSON for further analysis.
Metadata
Slug adaptive-trial-simulator
Version 0.1.0
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 1
Frequently Asked Questions

What is 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... It is an AI Agent Skill for Claude Code / OpenClaw, with 201 downloads so far.

How do I install Adaptive Trial Simulator?

Run "/install adaptive-trial-simulator" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Adaptive Trial Simulator free?

Yes, Adaptive Trial Simulator is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does Adaptive Trial Simulator support?

Adaptive Trial Simulator is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Adaptive Trial Simulator?

It is built and maintained by AIpoch (@aipoch-ai); the current version is v0.1.0.

💬 Comments