Agent skill

Clinical Research

by borghei in borghei/Claude-Skills

Clinical study operations — protocol structure, endpoint selection, eligibility design, sample-size and power planning, site feasibility, and documentation readiness.

MITAuto-check passedResearch & Science

Install Clinical Research

skills CLI
$ npx skills add borghei/Claude-Skills --skill clinical-research -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install borghei/Claude-Skills clinical-research --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/borghei/Claude-Skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/research-ops/clinical-research .claude/skills/clinical-research && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
clinical-research
GitHub stars
886
Token cost
~3.6k tokens
SKILL.md length
1,794 words
Files
12 (incl. scripts, references, assets)
Skills in repo
354
Repo updated
First seen
Licence
MIT

At a glance

Clinical study operations — protocol structure, endpoint selection, eligibility design, sample-size and power planning, site feasibility, and documentation readiness.

  • Works in 6 steps: Fix the primary endpoint and its type:… → State the effect size you want to detect… → Set alpha (0.05 two-sided unless the… → …
  • Costing a study
  • SKILL.md covers When to use this skill, Inputs the skill expects, Clarify First and Workflows, plus 3 more sections
  • Runs Python scripts from its folder; calls python3

What it does

Clinical Research is an agent skill from borghei/Claude-Skills. Clinical study operations — protocol structure, endpoint selection, eligibility design, sample-size and power planning, site feasibility, and documentation readiness. Use when planning, auditing, or costing a study.

Its SKILL.md is about 3.6k tokens, which your agent loads only when the skill is triggered. The skill folder holds 14 other files, including scripts, reference files and assets (for example `assets/protocol-outline-template.md`, `assets/sample_power_spec.json` and `assets/sample_protocol.json`).

It sits in Research & Science, covering Clinical and healthcare research and Experimental design. The repository describes itself as: 385 AI skills, 77 expert agents, and 900 stdlib Python tools for every team: engineering, PM, marketing, C-level, compliance, business ops, research, and a LinkedIn toolkit… The licence is MIT.

When your agent uses it

  • Costing a study
  • Tasks that involve Clinical and healthcare research
  • Tasks that involve Experimental design

Example prompts

  • “/clinical-research”

Requirements

  • Python 3

Workflow steps

6 steps, taken from the first numbered list in SKILL.md.

  1. Fix the primary endpoint and its type: binary, continuous, or time-to-event.
  2. State the effect size you want to detect and where it came from. [PROVEN]
  3. Set alpha (0.05 two-sided unless the protocol justifies otherwise), power
  4. Run the calculator. Read both the analysed n and the enrol n — the dropout
  5. If you have a fixed n constrained by budget or accrual, pass it as
  6. Take the result to a biostatistician. This step is not optional.

What it can do on your machine

Read from SKILL.md and the folder at commit 4a698e8. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 5 files in scripts/ (Python), which the agent can run.

    Shell commands in SKILL.md call:

    • python3

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Clinical Research loads about 3.6k tokens when it runs, and up to ~13k if it reads all its reference files. Until then it costs about 58 tokens; SKILL.md has 1,794 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~58
When it runs · the whole SKILL.md, loaded when a task matches
~3.6k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~13k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from borghei/Claude-Skills at commit 4a698e8, republished under its MIT licence (© borghei). 1,794 words, ~3,556 tokens.

Download SKILL.mdSave it as .claude/skills/clinical-research/SKILL.md (or your agent's skills folder). This skill also uses 11 other files; get the full folder from GitHub.
name
clinical-research
description
Clinical study operations — protocol structure, endpoint selection, eligibility design, sample-size and power planning, site feasibility, and documentation readiness. Use when planning, auditing, or costing a study.
license
MIT + Commons Clause
metadata.version
1.0.0
metadata.author
borghei
metadata.category
research-ops
metadata.domain
clinical-operations
metadata.updated
2026-07-21
metadata.tags
protocol, endpoints, sample-size, power, site-feasibility, ich-gcp

Clinical Research

Operational support for running clinical studies: structuring a protocol so it survives review, choosing endpoints that are actually analysable, designing eligibility criteria that do not strangle accrual, planning sample size and power, and testing whether the site network can deliver the enrolment target.

Scope and limits. This skill supports study operations — planning, structuring, and auditing. It is not a substitute for a qualified biostatistician, and it is not regulatory advice. The sample-size calculator assumes a simple parallel design with no interim analyses, multiplicity adjustment, covariate adjustment, or clustering; any design departing from those assumptions requires a statistician. The protocol auditor checks structure and internal consistency, not regulatory acceptability. Every artifact produced here needs sign-off from qualified biostatistics, clinical, and regulatory affairs personnel before it enters a submission.

When to use this skill

  • Planning a study and needing a defensible sample size before the budget and site count can be set
  • Auditing a draft protocol for missing ICH E6 elements before it goes to an ethics committee or a sponsor review board
  • Choosing between candidate endpoints where one is clinically meaningful and the other is achievable in the available sample
  • Designing inclusion and exclusion criteria and needing to see the accrual cost of each additional restriction
  • Assessing site feasibility — deciding how many sites, and which, are needed to hit an enrolment target inside the accrual window
  • Diagnosing an under-accruing study and deciding between adding sites, extending the window, or amending eligibility

Inputs the skill expects

  • Study phase, design (parallel, crossover, single-arm), and blinding
  • The primary question in a form that names the comparison
  • Candidate endpoints with their measurement instrument and timepoint
  • Effect size assumptions and their source — prior study, pilot, or literature
  • Expected dropout rate, from comparable studies where possible
  • For feasibility: candidate sites with eligible population, prior accrual attainment, startup time, and competing studies

Clarify First

Before generating, confirm these inputs. If any is unknown or vague, ASK — do not assume:

  • The primary endpoint and its measurement timepoint — everything downstream (sample size, visit schedule, site burden, cost) derives from it
  • The effect size and where it came from — a literature effect and a pilot effect carry very different uncertainty, and a pilot-derived SD needs an inflation allowance
  • Design features that break the simple formulas — interim analyses, co-primary endpoints, cluster randomisation, or crossover each require a different calculation and a statistician
  • The enrolment window and site network available — a sample size that cannot be accrued is not a plan

Stop rule: ask only the 2-3 that most change the output. If the user says "just draft it," proceed and list your assumptions at the top of the artifact.

Workflows

Workflow 1 — Plan sample size and power
  1. Fix the primary endpoint and its type: binary, continuous, or time-to-event. This selects the design, and the design selects the formula.
  2. State the effect size you want to detect and where it came from. [PROVEN] Power for the smallest effect that would change clinical practice, not for the effect you hope to see — the latter systematically under-powers studies.
  3. Set alpha (0.05 two-sided unless the protocol justifies otherwise), power (80% minimum, 90% where feasible), allocation ratio, and dropout rate.
  4. Run the calculator. Read both the analysed n and the enrol n — the dropout inflation is the number that drives the budget.
  5. If you have a fixed n constrained by budget or accrual, pass it as planned_n_per_group and read the achieved power instead.
  6. Take the result to a biostatistician. This step is not optional.
bash
python3 research-ops/clinical-research/scripts/sample_size_calculator.py \
  --input research-ops/clinical-research/assets/sample_power_spec.json \
  --format text
Workflow 2 — Audit a protocol outline
  1. Map the draft protocol's sections onto the ICH E6 element keys.
  2. Enter endpoints with role, measure, timepoint, and analysis population; enter inclusion and exclusion criteria verbatim.
  3. Run the auditor. It reports missing sections, endpoints that cannot be analysed as written, eligibility criteria that conflict or duplicate, and gaps in the statistical and safety sections.
  4. Clear every fail before circulating the draft. Missing sections and an unadjusted interim analysis are the two findings most likely to cost you a review cycle.
bash
python3 research-ops/clinical-research/scripts/protocol_auditor.py \
  --input research-ops/clinical-research/assets/sample_protocol.json \
  --format text
Workflow 3 — Test the site network against the enrolment target
  1. Collect per-site data: eligible annual population, self-reported accrual estimate, prior accrual attainment, startup time, coordinator status, and competing studies.
  2. Run the feasibility scorer. It discounts self-reported estimates, blends in the site's historical attainment, caps against eligible population, and subtracts startup time from the accrual window.
  3. Read the shortfall. If it is positive, the choice is more sites, a longer window, or looser eligibility — decide deliberately rather than discovering it at month 14.
  4. Use --select to test whether a smaller, higher-quality site set beats a larger one. It usually does on cost, and often on total accrual.
bash
python3 research-ops/clinical-research/scripts/site_feasibility_scorer.py \
  --input research-ops/clinical-research/assets/sample_sites.json \
  --select 5 --format text

Decision frameworks

Endpoint type drives everything
Endpoint typeDesignSample driverTypical relative n
Continuous (change in a scale)Two meansStandardised effect size δ/σSmallest
Binary (responder yes/no)Two proportionsAbsolute difference and baseline rate2-4x the continuous equivalent
Time-to-eventLog-rankHazard ratio and event probabilityDriven by events, not enrolment
Count / ratePoisson or negative binomialRate ratio and dispersionRequires a statistician
CompositeDepends on componentsThe component that dominatesInterpretation risk is high

[PROVEN] Where the same clinical question can be posed as continuous or binary, the continuous version needs materially fewer participants. Dichotomising a continuous measure discards information and inflates n — do it only when the threshold itself is what is clinically meaningful.

Effect size sources and their reliability
SourceReliabilityAdjustment
Large completed trial in the same population[PROVEN] highestUse as-is
Meta-analysis of comparable trials[PROVEN] highUse the pooled estimate; check heterogeneity
Single published trial, different population[RECOMMENDED] moderateDiscount by 20-30%; effects rarely transfer intact
Internal pilot study[RECOMMENDED] moderateAdd 10-15% to n; a pilot SD is imprecise
Clinician consensus on the minimum meaningful difference[RECOMMENDED]Best basis for the target, not for the variance
The effect needed to make the business case workNot a sourceThis is how under-powered studies get funded

That last row is a real failure mode. When the affordable sample size is back-solved into an effect size, the study is designed to fail and the failure is uninterpretable — you cannot distinguish "no effect" from "not enough people."

Show full SKILL.md (756 more words)Show less
Eligibility restrictiveness

Every criterion trades internal validity for accrual and generalisability.

Criteria countTypical effect
Under 15Broad, fast accrual, high generalisability
15-25Standard for a phase 3 study
25-35Screen failure rates climb steeply; accrual timelines stretch
Over 35Accrual frequently fails; the treated population may not resemble the studied one

[RECOMMENDED] For every criterion beyond about 20, require a written justification naming the specific safety or interpretability risk it addresses. Criteria accumulate through review by addition — nobody is ever assigned to remove one — and the cumulative accrual cost is invisible at the point each is added.

Anti-Patterns

Back-Solved Power

Mistake: Deciding the affordable sample size first, then choosing the effect size that makes that n reach 80% power. Why it happens: The budget is fixed before the science is planned, and the calculation is treated as a document to produce rather than a constraint to respect. Instead: Compute n from the smallest clinically meaningful effect. If that n is unaffordable, the honest options are to seek more funding, run a smaller study explicitly labelled as a pilot with a feasibility objective, or not run it. A study powered for an implausibly large effect consumes the same budget and produces an uninterpretable result.

The Optimistic Site Estimate

Mistake: Building the accrual plan on the enrolment rates sites report during feasibility questionnaires. Why it happens: Sites want to be selected, the estimate is made by someone who is not the person who will do the recruiting, and nobody is ever penalised for an optimistic feasibility response. Instead: Discount every self-reported estimate substantially and weight by the site's actual attainment on previous studies. Cross-check against the eligible population they reported — a site claiming 8 participants a month from a clinic seeing 180 eligible patients a year is claiming a screening yield that does not occur. Plan for the discounted number and treat outperformance as upside.

Criterion Creep

Mistake: Each protocol review round adds two or three exclusion criteria, and the final protocol has 40. Why it happens: Every reviewer can name a subgroup that might complicate interpretation, and adding an exclusion is a costless-looking way to resolve the comment. Nobody's job is to remove one. Instead: Cap the criteria count in the protocol plan and treat additions as trade-offs requiring an explicit removal or a written justification of the accrual cost. Track the projected screen failure rate as criteria accumulate and put that number in front of reviewers.

The Unanalysable Endpoint

Mistake: A primary endpoint like "improvement in patient wellbeing" with no named instrument, threshold, or timepoint. Why it happens: It is written early as a placeholder during objective-setting and is never converted into an operational definition. Instead: Every endpoint needs four things before the protocol circulates: the instrument, the metric derived from it, the threshold or contrast that defines the outcome, and the timepoint. If any of the four is missing, the endpoint cannot be powered, collected consistently, or analysed.

Silent Interim Looks

Mistake: Planning an interim analysis without an alpha spending function, or examining accumulating data informally "just to see how it is going." Why it happens: Interim looks feel like prudent management, and the statistical cost is invisible to anyone not looking for it. Instead: Pre-specify every interim analysis with its alpha spending function and stopping boundaries, and restrict access to unblinded accumulating data to an independent monitoring committee. Unadjusted repeated testing inflates type I error, and an informal look by the sponsor team compromises the trial's integrity even when nothing is acted on.

Files

FilePurpose
scripts/sample_size_calculator.pySample size and power CLI: input validation, dropout inflation, planning warnings, and reporting
scripts/power_formulas.pyDesign formulas imported by sample_size_calculator.py: the two-proportion, two-mean (with t-correction), and log-rank sample-size calculations, the achieved-power inversions, and the method notes reported with every result. Edit here to revise the statistics
scripts/protocol_auditor.pyAudits a protocol outline against ICH E6 elements, endpoint definitions, and eligibility consistency
scripts/protocol_rules.pyRule definitions imported by protocol_auditor.py: the ICH E6 required-section table and its guidance strings, vague-measure and DSMB-phase thresholds, the SAE reporting window, severity ordering, and the finding accumulator. Edit here to revise what the audit expects
scripts/site_feasibility_scorer.pyDiscounts site accrual estimates and tests the network against the enrolment target
references/protocol-and-endpoint-design.mdICH E6 protocol contents, endpoint hierarchies, eligibility design, estimand framing
references/statistical-planning.mdFormulas, worked examples, design effects, interim analysis, and when to escalate to a statistician
assets/protocol-outline-template.mdThe protocol skeleton with every required element
assets/sample_power_spec.jsonRunnable input for the sample size calculator
assets/sample_protocol.jsonRunnable input for the protocol auditor
assets/sample_sites.jsonRunnable input for the site feasibility scorer

© borghei, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 11 other files (scripts, references, assets) in research-ops/clinical-research of borghei/Claude-Skills.

  • SKILL.md
  • assets/protocol-outline-template.md
  • assets/sample_power_spec.json
  • assets/sample_protocol.json
  • assets/sample_sites.json
  • references/protocol-and-endpoint-design.md
  • references/statistical-planning.md
  • scripts/power_formulas.py
  • scripts/protocol_auditor.py
  • scripts/protocol_rules.py
  • scripts/sample_size_calculator.py
  • scripts/site_feasibility_scorer.py

Open the folder on GitHubat commit 4a698e8

Compare with similar skills

Clinical Research next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Clinical Research compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Clinical Research this skillborghei/Claude-Skills886—~3.6kAutomated safety check: PassMIT
Clinical Protocol Draftingaws-samples/amazon-bedrock-agents-healthcare-lifesciences274—~1.4kAutomated safety check: PassMIT-0
Clinical Researchalirezarezvani/claude-skills28k—~2.7kAutomated safety check: PassMIT
Bio Clinical Biostatistics Adaptive DesignsGPTomics/bioSkills1.2k2 repos~7.7kAutomated safety check: PassMIT
Bio Clinical Biostatistics Power Sample SizeGPTomics/bioSkills1.2k2 repos~7.9kAutomated safety check: PassMIT
Adaptive Trial Simulatoraipoch/medical-research-skills2k—~3kAutomated safety check: PassMIT

Similar skills

  • Clinical Protocol Drafting

    aws-samples/amazon-bedrock-agents-healthcare-lifesciences

    Official

    A skill your agent uses when drafting clinical trial protocol sections (objectives, background, study design) grounded in ICH guidelines (E6, E8, E9) and FDA regulations (21 CFR Part 312).

    274 GitHub stars~1.4k tokensUpdated 7 days ago
    Research & ScienceAuto-check passed
  • Clinical Research

    alirezarezvani/claude-skills

    A skill your agent uses when designing a prospective clinical study before submission — selecting and classifying endpoints (primary / key-secondary / exploratory, with surrogate-endpoint flagging)…

    28k GitHub stars~2.7k tokensUpdated 1 mo ago
    Research & ScienceAuto-check passed
  • Designs adaptive clinical trials including group-sequential (O'Brien-Fleming, Pocock, Lan-DeMets spending), sample-size re-estimation (blinded Friede-Kieser, unblinded Cui-Hung-Wang, Mehta-Pocock…

    1.2k GitHub starsUsed in 2 repos~7.7k tokens
    Research & ScienceAuto-check passed
  • Computes sample size and power for clinical trials including continuous, binary, and time-to-event endpoints; superiority, non-inferiority, and equivalence designs; FDA 2016 non-inferiority margin…

    1.2k GitHub starsUsed in 2 repos~7.9k tokens
    Research & ScienceAuto-check passed
  • Adaptive Trial Simulator

    aipoch/medical-research-skills

    Design and simulate adaptive clinical trials with interim analyses, decision rules, and operating-characteristic summaries; use when planning adaptive designs or comparing stopping, enrichment, or…

    2k GitHub stars~3k tokensUpdated 22 days ago
    Research & ScienceAuto-check passed
  • Sample Size Basic

    aipoch/medical-research-skills

    Basic sample size estimator for clinical research planning. An agent skill from aipoch/medical-research-skills.

    2k GitHub stars~1.6k tokensUpdated 22 days ago
    Research & ScienceAuto-check passed

More from borghei/Claude-Skills

All 354 skills in this repo
  • Agent Harness

    borghei/Claude-Skills

    Test and evaluation harness for AI agents — scenario suites, deterministic replay, regression diffing, cost and latency budgets.

    886 GitHub stars~3.1k tokensUpdated 2 days ago
    Auto-check passed
  • Agents In The Team

    borghei/Claude-Skills

    Run delivery when AI coding and ops agents take tickets. An agent skill from borghei/Claude-Skills.

    886 GitHub stars~4.2k tokensUpdated 2 days ago
    Auto-check passed
  • AI Content Disclosure

    borghei/Claude-Skills

    Check AI-generated marketing content and reviews for required disclosures under the EU AI Act, FTC rules and platform AI-label policies.

    886 GitHub stars~3.4k tokensUpdated 2 days ago
    Auto-check passed
  • AI Prototyping

    borghei/Claude-Skills

    Idea to AI-generated prototype to customer validation to engineering handoff.

    886 GitHub stars~3.6k tokensUpdated 2 days ago
    Auto-check passed
  • Analytics Engineer

    borghei/Claude-Skills

    Analytics engineering across data modeling, dbt, transformation, and semantic layers.

    886 GitHub stars~3.4k tokensUpdated 2 days ago
    Auto-check passed
  • Ansoff Matrix

    borghei/Claude-Skills

    Ansoff Matrix — 4-quadrant framework for growth options: market penetration, market/product development, and diversification.

    886 GitHub stars~2.2k tokensUpdated 2 days ago
    Auto-check passed

Questions about Clinical Research

What does Clinical Research do?

Clinical study operations — protocol structure, endpoint selection, eligibility design, sample-size and power planning, site feasibility, and documentation readiness. Clinical Research is an agent skill from borghei/Claude-Skills. Clinical study operations — protocol structure, endpoint selection, eligibility design, sample-size and power planning, site feasibility, and documentation readiness.

When should I use Clinical Research?

Clinical Research fits situations like: costing a study; tasks that involve Clinical and healthcare research; tasks that involve Experimental design.

How do I install Clinical Research in Claude Code?

Run `npx skills add borghei/Claude-Skills --skill clinical-research -a claude-code`. Or copy the skill folder (research-ops/clinical-research in borghei/Claude-Skills) into .claude/skills/clinical-research in your project. Claude Code loads it when a task matches its description.

How do I install Clinical Research in Codex?

Run `npx skills add borghei/Claude-Skills --skill clinical-research -a codex`. Or copy the skill folder (research-ops/clinical-research in borghei/Claude-Skills) into .agents/skills/clinical-research in your project. Codex loads it when a task matches its description.

Can I use Clinical Research in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add borghei/Claude-Skills --skill clinical-research -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/clinical-research, .gemini/skills/clinical-research, .github/skills/clinical-research and .opencode/skills/clinical-research in your project.

What does Clinical Research need to run?

Going by SKILL.md and its folder, Clinical Research needs Python for the scripts in its folder and the command-line tools its instructions call (python3). Our summary lists: Python 3.

Does Clinical Research access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Clinical Research safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Clinical Research use?

Clinical Research is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Clinical Research use?

About 3.6k tokens (SKILL.md is roughly 14k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 9.3k tokens, read only when the agent opens those files.

What are the alternatives to Clinical Research?

Skills that share tags, products or a category with Clinical Research: Clinical Protocol Drafting (aws-samples/amazon-bedrock-agents-healthcare-lifesciences, 274 stars), Clinical Research (alirezarezvani/claude-skills, 28k stars), Bio Clinical Biostatistics Adaptive Designs (GPTomics/bioSkills, 1.2k stars) and Bio Clinical Biostatistics Power Sample Size (GPTomics/bioSkills, 1.2k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Clinical Research?

borghei (a GitHub user) maintains it in borghei/Claude-Skills, which has 886 GitHub stars. The repository holds 354 skills in this directory. The repository was last updated on October 7, 2026.

Source: borghei/Claude-Skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.