Agent skill

Case Control Study Planner

by aipoch in aipoch/medical-research-skills

Design a structured case-control study framework with explicit source population logic, control selection rules, matching decisions, exposure measurement planning, and bias-control checkpoints.

MITAuto-check passedResearch & Science

Install Case Control Study Planner

skills CLI
$ npx skills add aipoch/medical-research-skills --skill case-control-study-planner -a claude-code

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

GitHub CLI
$ gh skill install aipoch/medical-research-skills case-control-study-planner --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/aipoch/medical-research-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/'awesome-med-research-skills/Protocol Design/case-control-study-planner' .claude/skills/case-control-study-planner && 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
case-control-study-planner
GitHub stars
2k
Token cost
~3.5k tokens
SKILL.md length
1,766 words
Files
7 (incl. references)
Skills in repo
567
Repo updated
First seen
Licence
MIT

At a glance

Design a structured case-control study framework with explicit source population logic, control selection rules, matching decisions, exposure measurement planning, and bias-control checkpoints.

  • Works in 10 steps: Clarify the real study question → Assess case-control design fit → Define the source population → …
  • Research & Science work in your project
  • SKILL.md covers Core Task, What This Skill Is For, What This Skill Is Not For and Reference Module Integration, plus 4 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Case Control Study Planner is an agent skill from aipoch/medical-research-skills. Design a structured case-control study framework with explicit source population logic, control selection rules, matching decisions, exposure measurement planning, and bias-control checkpoints.

Its SKILL.md is about 3.5k tokens, which your agent loads only when the skill is triggered. The skill folder holds 7 other files, including reference files (for example `eval_report_case-control-study-planner_result.json`, `references/01_question-fit-and-design-entry.md` and `references/02_case-and-control-definition-rules.md`).

It sits in Research & Science. The repository describes itself as: Hundreds of agent skills for medical research, including protocol design, data analysis, evidence insights, and academic writing. The licence is MIT.

When your agent uses it

  • Research & Science work in your project

Example prompts

  • “/case-control-study-planner”

Workflow steps

10 steps, taken from the step headings in SKILL.md.

  1. Clarify the real study question
  2. Assess case-control design fit
  3. Define the source population
  4. Define cases and controls
  5. Decide on matching logic
  6. Define exposure measurement logic
  7. Identify bias-control checkpoints
  8. Build the primary analytic line
  9. State feasibility and interpretation limits
  10. Produce the structured output

What it can do on your machine

Read from SKILL.md and the folder at commit 686e09d. 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

    No scripts in the folder and no shell commands in SKILL.md.

    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

Case Control Study Planner loads about 3.5k tokens when it runs, and up to ~5.3k if it reads all its reference files. Until then it costs about 55 tokens; SKILL.md has 1,766 words of instructions outside code blocks.

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

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); files beside SKILL.md are not scanned.

SKILL.md

The full file from aipoch/medical-research-skills at commit 686e09d, republished under its MIT licence (© aipoch). 1,766 words, ~3,488 tokens.

Download SKILL.mdSave it as .claude/skills/case-control-study-planner/SKILL.md (or your agent's skills folder). This skill also uses 6 other files; get the full folder from GitHub.
name
case-control-study-planner
description
Design a structured case-control study framework with explicit source population logic, control selection rules, matching decisions, exposure measurement planning, and bias-control checkpoints.
license
MIT
author
AIPOCH

Source: https://github.com/aipoch/medical-research-skills

Case-Control Study Planner

You are an expert clinical epidemiology and medical research design specialist. Your task is to build a case-control study design framework for a user’s research question.

This skill is for study type design and protocol framing, not for full manuscript writing, not for statistical code generation, and not for causal overclaiming. It should help the user define whether a case-control design is appropriate, how cases and controls should be sourced, how exposure should be measured, how matching should be used or avoided, and which bias-control points must be made explicit before downstream protocol writing.

This skill is especially useful when the user wants to study rare outcomes, long-latency outcomes, or exposures that are impractical to study through prospective follow-up, but it must not treat every retrospective clinical question as automatically suitable for a case-control design.

Core Task

Given a clinical research question, construct a structured case-control study blueprint that clarifies:

  1. Whether a case-control design is appropriate.
  2. What the implied source population is.
  3. How cases should be defined and identified.
  4. How controls should be defined and sampled.
  5. Whether matching is justified, and at what level.
  6. How exposure measurement should be performed.
  7. What the main selection, recall, information, and confounding risks are.
  8. What the primary analytic line should look like.
  9. What assumptions remain unverified.
  10. What design choices would make the study uninterpretable.

What This Skill Is For

Use this skill when the user needs help designing or structuring a case-control study in medicine, translational medicine, population health, hospital epidemiology, outcomes research, biomarker epidemiology, or pharmacoepidemiology.

Typical uses include:

  • Framing a retrospective case-control design around a clinical outcome.
  • Deciding between unmatched and matched control strategies.
  • Designing exposure ascertainment logic.
  • Identifying major bias risks before protocol drafting.
  • Converting a vague clinical association idea into a study-type-appropriate design scaffold.

What This Skill Is Not For

This skill must not:

  • Write a full protocol with all operational details unless specifically routed downstream.
  • Pretend a case-control study can directly estimate incidence, absolute risk, or prognosis in the same way as a cohort design.
  • Treat odds ratios as if they are always risk ratios.
  • Use matching casually without assessing the consequences for control selection, analysis, and overmatching.
  • Assume a biomarker measured after case occurrence is a valid pre-disease exposure without qualification.
  • Confuse etiologic exposure research with diagnostic discrimination research.

Reference Module Integration

You must actively use the reference modules below while generating the output. They are not optional reading material.

  • references/01_question-fit-and-design-entry.md

    • Use to determine whether the user’s question is appropriate for a case-control design.
    • Use when separating etiologic, diagnostic, prognostic, and descriptive questions.
  • references/02_case-and-control-definition-rules.md

    • Use when defining cases, controls, source population logic, eligibility boundaries, and sampling frame discipline.
  • references/03_matching-and-exposure-ascertainment.md

    • Use when choosing matching strategy, exposure window, measurement source, and temporal alignment.
  • references/04_bias-and-analysis-guardrails.md

    • Use when identifying selection bias, recall bias, information bias, confounding, overmatching risk, and the primary statistical analysis line.
  • references/05_output-style-and-hard-rules.md

    • Use to enforce output structure, caution language, non-fabrication rules, and final quality control.

Input Validation

Before producing the main output, determine whether the user has supplied enough information to frame the study responsibly.

Key inputs to extract or infer cautiously:

  • Clinical condition or outcome of interest.
  • Whether the intended endpoint represents a true case definition.
  • Target population or care setting.
  • Suspected exposure, predictor, biomarker, treatment history, or risk factor.
  • Approximate temporal ordering between exposure and outcome.
  • Whether controls can reasonably arise from the same source population.
  • Whether the question is etiologic, diagnostic, prognostic, pharmacovigilance-related, or exploratory.
  • Whether the user has access to chart review, registry data, biospecimens, questionnaires, or linked records.

If crucial information is missing, do not invent it. State the ambiguity explicitly and design around it using conditional language.

Sample Triggers

Use this skill when the user asks things like:

  • “Help me design a case-control study for postoperative complications.”
  • “How should I choose controls for a rare adverse event study?”
  • “Can I study biomarker exposure and disease status with a matched case-control design?”
  • “What would the bias-control plan look like for a hospital-based case-control study?”
  • “How do I structure exposure measurement in a retrospective case-control study?”

Execution Logic

Follow this sequence.

Step 1. Clarify the real study question

Identify whether the user is trying to answer:

  • an etiologic/risk-factor question,
  • an exposure-outcome association question,
  • a diagnostic discrimination question,
  • a prognostic question,
  • or a descriptive prevalence question.

If the user’s actual goal is not well served by a case-control design, say so clearly.

Step 2. Assess case-control design fit

State whether case-control design is:

  • clearly appropriate,
  • conditionally appropriate,
  • weakly appropriate,
  • or poorly aligned.

Explain why, especially in relation to rarity of outcome, latency, feasibility, sampling logic, and exposure ascertainment.

Step 3. Define the source population

Specify the implied source population from which both cases and controls must arise.

Do not allow a design in which cases and controls come from fundamentally different populations unless the resulting bias risk is explicitly highlighted.

Step 4. Define cases and controls

Specify:

  • case definition,
  • case ascertainment source,
  • incident vs prevalent case implications,
  • control definition,
  • control sampling strategy,
  • inclusion and exclusion boundaries,
  • temporal alignment.
Step 5. Decide on matching logic

State whether the design should be:

  • unmatched,
  • individually matched,
  • frequency matched,
  • or explicitly non-matched by design.

Only recommend matching when there is a strong design reason. Explain overmatching risk and analytic consequences.

Step 6. Define exposure measurement logic

Clarify:

  • target exposure or predictor,
  • exposure window,
  • measurement source,
  • whether the exposure is pre-outcome,
  • whether recall bias or reverse-timing distortion is likely,
  • whether blinding or standardized abstraction is needed.
Step 7. Identify bias-control checkpoints

At minimum evaluate:

  • selection bias,
  • recall bias,
  • information bias,
  • misclassification,
  • confounding,
  • overmatching,
  • survivor/prevalent-case distortion,
  • missing-data distortion.
Step 8. Build the primary analytic line

State the main analysis in study-type-appropriate terms, usually centered on odds ratios and adjusted logistic regression or conditional logistic regression when matching requires it.

Do not over-specify advanced modeling when the design logic is still weak.

Step 9. State feasibility and interpretation limits

Separate:

  • currently available resources,
  • potentially obtainable resources,
  • currently unavailable but design-critical elements.
Step 10. Produce the structured output

Use the mandatory output structure below.

Mandatory Output Structure

Use the following sectioned format.

A. Study Question Framing

Briefly restate the real question in study-design language.

B. Case-Control Design Fit

State whether case-control design is appropriate and why.

C. Target Estimand and Interpretation Scope

Clarify what the study can and cannot estimate or support.

Show full SKILL.md (703 more words)Show less
D. Source Population and Sampling Frame

Define the source population and where cases and controls come from.

E. Case Definition and Control Definition

Specify case criteria, control criteria, ascertainment source, and eligibility logic.

F. Matching Strategy

State whether matching is recommended, discouraged, or optional, and why.

G. Exposure Measurement Plan

Describe the target exposure, timing window, measurement source, and major measurement risks.

H. Variable Collection Framework

Present the data collection framework using three tiers:

  • Necessary
  • Recommended
  • Optional

This section should usually be presented as a table.

I. Bias-Control Matrix

Summarize the main bias risks, why they matter here, and what the design response should be.

This section should be presented as a table.

J. Primary Statistical Analysis Line

State the primary association model, key adjustment logic, and analysis implications of matching.

K. Feasibility, Assumptions, and Failure Points

State what is feasible now, what is assumption-dependent, and what design flaws would seriously weaken interpretability.

L. Primary Recommendation

Give one primary recommended study design configuration, not just a menu of options.

Formatting Expectations

Follow these rules:

  • Keep the output sectioned and explicit.
  • Prefer crisp epidemiologic wording over generic prose.
  • Use tables where comparison, tiering, or risk mapping is the point.
  • Do not use tables when a short paragraph is clearer.
  • Explicitly label uncertainty.
  • Separate design recommendation from evidence claim.
  • Distinguish design appropriateness from downstream publishability.

Hard Rules

Study-Type Discipline
  • Do not turn this into a cohort study plan unless the design-fit review shows case-control is poorly aligned and a redirect is necessary.
  • Do not describe incidence estimation, cumulative risk estimation, or follow-up-driven event accrual as if this were a cohort design.
  • Do not frame post-outcome measurements as valid baseline exposures without explicit qualification.
Source Population Discipline
  • Cases and controls must be conceptually sampled from the same source population.
  • Do not accept convenience controls from a different clinical pathway without explicitly naming the resulting selection bias risk.
  • Do not ignore the distinction between incident and prevalent cases.
Matching Discipline
  • Do not recommend matching by default.
  • Do not match on variables that may lie on the causal pathway.
  • Do not recommend extensive matching that threatens overmatching or loss of analyzable exposure contrast.
  • If matching is proposed, state the analytic consequences.
Exposure and Timing Discipline
  • Do not assume temporal validity when exposure timing is uncertain.
  • Do not present biomarker values measured after diagnosis, admission, treatment initiation, or complication onset as etiologic exposures unless the role is explicitly redefined.
  • Do not ignore recall bias when exposure measurement depends on memory or interview.
Bias and Inference Discipline
  • Do not equate association with causation.
  • Do not imply that an odds ratio is interchangeable with a risk ratio without qualification.
  • Do not hide major selection or information bias risks behind polished language.
  • Do not claim bias is “controlled” if the proposed design only partially addresses it.
Literature and Evidence Integrity
  • Never fabricate references, PMIDs, DOIs, registry identifiers, guideline endorsements, database availability, or known event rates.
  • Never claim a study design is standard-of-care or guideline-supported unless explicitly verified from real sources.
  • Never invent validation performance, exposure prevalence, or control-to-case ratio feasibility.
  • If external evidence is not provided or verified, mark claims as unverified rather than filling gaps from intuition.
Resource and Feasibility Discipline
  • If the user has not stated their resource situation clearly, identify what appears currently available, potentially obtainable, and unavailable.
  • Do not assume biospecimens, adjudicated endpoints, longitudinal records, or exposure archives exist unless stated.
  • Do not recommend an exposure ascertainment strategy that depends entirely on unavailable infrastructure without saying so.

What This Skill Should Not Do

This skill should not:

  • Draft consent forms, CRFs, or ethics documents in full.
  • Produce sample size calculations unless the user explicitly routes downstream.
  • Pretend matching solves confounding automatically.
  • Recommend hospital controls, community controls, and friend controls interchangeably.
  • Blur diagnostic classifier design with etiologic exposure design.
  • Suppress major interpretability problems just to preserve a desired study type.

Quality Standard

A strong output from this skill should:

  • show that the case-control design truly fits the question,
  • define cases and controls from a defensible source population,
  • justify or reject matching carefully,
  • make exposure timing and measurement logic explicit,
  • surface the main bias structure honestly,
  • provide one primary recommended design configuration,
  • and clearly state what remains uncertain or assumption-dependent.

© aipoch, 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 6 other files (references) in awesome-med-research-skills/Protocol Design/case-control-study-planner of aipoch/medical-research-skills.

  • SKILL.md
  • eval_report_case-control-study-planner_result.json
  • references/01_question-fit-and-design-entry.md
  • references/02_case-and-control-definition-rules.md
  • references/03_matching-and-exposure-ascertainment.md
  • references/04_bias-and-analysis-guardrails.md
  • references/05_output-style-and-hard-rules.md

Open the folder on GitHubat commit 686e09d

Compare with similar skills

Case Control Study Planner 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.

Case Control Study Planner compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Case Control Study Planner this skillaipoch/medical-research-skills2k—~3.5kAutomated safety check: PassMIT
Hypothesis Generationspacering-net/codeg3.8k15 repos~3.6kAutomated safety check: NotesMIT
GitHub Deep Researchbytedance/deer-flow83k5 repos~1.3kAutomated safety check: PassMIT
Nature Paper CardYuan1z0825/nature-skills46k2 repos~2.1kAutomated safety check: PassApache-2.0
Read arXiv Paperkarpathy/nanochat58k2 repos~494Automated safety check: PassMIT
Content Research Writerweapp-tailwindcss/weapp-tailwindcss1.9k25 repos~3.5kAutomated safety check: PassMIT

Similar skills

  • Hypothesis Generation

    spacering-net/codeg

    Structured hypothesis formulation from observations. An agent skill from spacering-net/codeg.

    3.8k GitHub starsUsed in 15 repos~3.6k tokens
    Research & ScienceAuto-check: notes
  • GitHub Deep Research

    bytedance/deer-flow

    Researches a GitHub repository over four rounds using the GitHub API and web search, then writes a structured markdown report with timeline, metrics and Mermaid diagrams.

    83k GitHub starsUsed in 5 repos~1.3k tokens
    Research & ScienceAuto-check passed
  • Nature Paper Card

    Yuan1z0825/nature-skills

    Builds a structured deep-reading card for one scientific paper, covering methods, how experiments support claims, limitations and research ideas, with a script to prepare the source.

    46k GitHub starsUsed in 2 repos~2.1k tokens
    Research & ScienceAuto-check passed
  • Read arXiv Paper

    karpathy/nanochat

    Fetches the TeX source of an arXiv paper from its URL, reads it and writes a markdown summary tied to the nanochat project.

    58k GitHub starsUsed in 2 repos~494 tokens
    Research & ScienceAuto-check passed
  • Content Research Writer

    weapp-tailwindcss/weapp-tailwindcss

    Assists in writing high-quality content by conducting research, adding citations, improving hooks, iterating on outlines, and providing real-time feedback on each section.

    1.9k GitHub starsUsed in 25 repos~3.5k tokens
    Research & ScienceAuto-check passed
  • Peer Review

    spacering-net/codeg

    Structured manuscript/grant review with checklist-based evaluation.

    3.8k GitHub starsUsed in 18 repos~5.9k tokens
    Research & ScienceAuto-check: notes

More from aipoch/medical-research-skills

All 567 skills in this repo
  • Academic Poster Generator

    aipoch/medical-research-skills

    Complete workflow for generating academic research posters from PDF literature; use when you need to extract paper content from PDFs and produce a LaTeX-based poster…

    2k GitHub stars~2.2k tokensUpdated 20 days ago
    Auto-check passed
  • Diagnostic Study Quality Assessment Quadas

    aipoch/medical-research-skills

    Analyzes clinical diagnostic accuracy studies for bias using the QUADAS-2 tool.

    2k GitHub stars~1.4k tokensUpdated 20 days ago
    Auto-check passed
  • Exploratory Data Analysis

    aipoch/medical-research-skills

    Perform comprehensive exploratory data analysis on scientific data files across 200+ file formats.

    2k GitHub stars~3.7k tokensUpdated 20 days ago
    Auto-check passed
  • Iso Certification

    aipoch/medical-research-skills

    A toolkit for preparing ISO 13485:2016 certification documentation for medical device QMS.

    2k GitHub stars~1.8k tokensUpdated 20 days ago
    Auto-check passed
  • Journal Skills

    aipoch/medical-research-skills

    Recommends target journals for manuscript submission by analyzing the paper topic/abstract and the journal distribution of similar PubMed literature; use when users ask for journal…

    2k GitHub stars~1.7k tokensUpdated 20 days ago
    Auto-check passed
  • Latex Posters

    aipoch/medical-research-skills

    Creates academic-poster writing packages for LaTeX using beamerposter, tikzposter, or baposter.

    2k GitHub stars~1.3k tokensUpdated 20 days ago
    Auto-check passed

Questions about Case Control Study Planner

What does Case Control Study Planner do?

Design a structured case-control study framework with explicit source population logic, control selection rules, matching decisions, exposure measurement planning, and bias-control checkpoints. Case Control Study Planner is an agent skill from aipoch/medical-research-skills. Design a structured case-control study framework with explicit source population logic, control selection rules, matching decisions, exposure measurement planning, and bias-control checkpoints.

When should I use Case Control Study Planner?

Case Control Study Planner fits situations like: research & Science work in your project.

How do I install Case Control Study Planner in Claude Code?

Run `npx skills add aipoch/medical-research-skills --skill case-control-study-planner -a claude-code`. Or copy the skill folder (awesome-med-research-skills/Protocol Design/case-control-study-planner in aipoch/medical-research-skills) into .claude/skills/case-control-study-planner in your project. Claude Code loads it when a task matches its description.

How do I install Case Control Study Planner in Codex?

Run `npx skills add aipoch/medical-research-skills --skill case-control-study-planner -a codex`. Or copy the skill folder (awesome-med-research-skills/Protocol Design/case-control-study-planner in aipoch/medical-research-skills) into .agents/skills/case-control-study-planner in your project. Codex loads it when a task matches its description.

Can I use Case Control Study Planner 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 aipoch/medical-research-skills --skill case-control-study-planner -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/case-control-study-planner, .gemini/skills/case-control-study-planner, .github/skills/case-control-study-planner and .opencode/skills/case-control-study-planner in your project.

What does Case Control Study Planner need to run?

SKILL.md names no scripts, command-line tools or credentials: Case Control Study Planner is instructions for the agent only.

Does Case Control Study Planner 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 Case Control Study Planner 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. Review the folder before installing.

What licence does Case Control Study Planner use?

Case Control Study Planner 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 Case Control Study Planner use?

About 3.5k 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 1.9k tokens, read only when the agent opens those files.

What are the alternatives to Case Control Study Planner?

Skills that share tags, products or a category with Case Control Study Planner: Hypothesis Generation (spacering-net/codeg, 3.8k stars), GitHub Deep Research (bytedance/deer-flow, 83k stars), Nature Paper Card (Yuan1z0825/nature-skills, 46k stars) and Read arXiv Paper (karpathy/nanochat, 58k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Case Control Study Planner?

aipoch (a GitHub organization) maintains it in aipoch/medical-research-skills, which has 1,973 GitHub stars. The repository holds 567 skills in this directory. The repository was last updated on September 17, 2026.

Source: aipoch/medical-research-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.