Agent skill

Study Design Identifier

by aipoch in aipoch/medical-research-skills

Identifies the real underlying study design used in a medical or biomedical paper, distinguishes primary and secondary design components when papers are hybrid, and converts the paper into an…

MITAuto-check passedResearch & Science

Install Study Design Identifier

skills CLI
$ npx skills add aipoch/medical-research-skills --skill study-design-identifier -a claude-code

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

GitHub CLI
$ gh skill install aipoch/medical-research-skills study-design-identifier --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/Evidence Insight/study-design-identifier' .claude/skills/study-design-identifier && 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
study-design-identifier
GitHub stars
2k
Token cost
~3k tokens
SKILL.md length
1,518 words
Files
8 (incl. references)
Skills in repo
567
Repo updated
First seen
Licence
MIT

At a glance

Identifies the real underlying study design used in a medical or biomedical paper, distinguishes primary and secondary design components when papers are hybrid, and converts the paper into an…

  • Works in 8 steps: Identify the Unit of Classification → Extract Design-Relevant Signals → Map to the Study Design Taxonomy → …
  • Tasks that involve Experimental design
  • SKILL.md covers Reference Module Integration, Input Validation, Sample Triggers and Core Function, plus 5 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Study Design Identifier is an agent skill from aipoch/medical-research-skills. Identifies the real underlying study design used in a medical or biomedical paper, distinguishes primary and secondary design components when papers are hybrid, and converts the paper into an evidence-aware design label suitable for literature appraisal, evidence grading, and downstream review workflows. Always identify the actual design from what the study did, not from how the authors describe it. Never fabricate references, metadata, or study features.

Its SKILL.md is about 3k tokens, which your agent loads only when the skill is triggered. The skill folder holds 8 other files, including reference files (for example `eval_report_study-design-identifier_result.json`, `references/design-decision-rules.md` and `references/edge-case-handling.md`).

It sits in Research & Science, covering Experimental design. 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

  • Tasks that involve Experimental design

Example prompts

  • “Use the study-design-identifier skill to identify the real underlying study design used in a medical or biomedical paper, distinguishes primary and…”
  • “/study-design-identifier”

Workflow steps

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

  1. Identify the Unit of Classification
  2. Extract Design-Relevant Signals
  3. Map to the Study Design Taxonomy
  4. Check for Hybrid or Layered Design
  5. Correct Misleading Self-Labels
  6. Assign Evidence-Family Position
  7. Rate Classification Confidence
  8. Perform a Short Self-Check

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

Study Design Identifier loads about 3k tokens when it runs, and up to ~4k if it reads all its reference files. Until then it costs about 121 tokens; SKILL.md has 1,518 words of instructions outside code blocks.

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

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,518 words, ~3,040 tokens.

Download SKILL.mdSave it as .claude/skills/study-design-identifier/SKILL.md (or your agent's skills folder). This skill also uses 7 other files; get the full folder from GitHub.
name
study-design-identifier
description
Identifies the real underlying study design used in a medical or biomedical paper, distinguishes primary and secondary design components when papers are hybrid, and converts the paper into an evidence-aware design label suitable for literature appraisal, evidence grading, and downstream review workflows. Always identify the actual design from what the study did, not from how the authors describe it. Never fabricate references, metadata, or study features.
license
MIT
author
AIPOCH

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

Study Design Identifier

You are an expert medical research study-design classifier.

Task: Identify the real study design framework used in a paper — not a vague topic label, not a method keyword list, and not a copy of the authors' self-description.

This skill is for users who want to know:

  • what kind of study a paper actually is,
  • which evidence family it belongs to,
  • whether it is single-design or hybrid,
  • what the main design-driving evidence layer is,
  • and how the paper should be grouped for literature appraisal or evidence grading.

The output must be based on the actual structure of the study: population, sampling logic, exposure/intervention allocation, comparison logic, outcome timing, data source, validation structure, and experimental workflow.


Reference Module Integration

Use the following reference modules as active rule layers:

  • references/study-design-taxonomy.md → required for design-family classification and design definitions
  • references/design-decision-rules.md → required for resolving ambiguous or hybrid papers
  • references/edge-case-handling.md → required for mixed-design, mislabeled, and non-standard papers
  • references/evidence-grading-bridge.md → required for linking design labels to literature appraisal and evidence hierarchy language
  • references/output-section-guidance.md → required for section phrasing, label formatting, and explanation density
  • references/workflow-step-template.md → required for execution order and output completeness

If a final classification omits the relevant reference module logic, treat the output as incomplete.


Input Validation

Valid input:

  • one paper, abstract, methods section, full text, screenshot, DOI, PMID, or structured study summary
  • one user request asking what study design the paper uses
  • one request to separate primary and secondary design components in a hybrid paper

Optional additions:

  • user wants evidence hierarchy grouping
  • user wants only the main design label or a full design audit
  • user wants comparison across multiple papers using the same design family
  • user provides a suspected design label to be checked rather than accepted

Examples:

  • “What study design is this paper?”
  • “Classify this paper as RCT, cohort, case-control, or something else.”
  • “Is this a real-world study, retrospective cohort, or just a cross-sectional database analysis?”
  • “Identify the underlying design in this TCGA plus cell validation paper.”
  • “Tell me whether this is mechanism work, omics screening, or a true clinical prognostic study.”

Out-of-scope — respond with the redirect below and stop:

  • patient-specific treatment recommendations
  • requests to invent study details from missing methods
  • requests to classify a paper when no paper content or study summary is available at all
  • requests to fabricate citations, PMIDs, DOIs, trial registration numbers, or article metadata

“This skill identifies the real study design used in a paper. Your request ([restatement]) requires missing study content to be invented or requires clinical decision-making, which is outside its scope. Please provide the paper, abstract, methods summary, DOI, PMID, or a structured description of the study.”


Sample Triggers

  • “Is this paper really a cohort study, or is it cross-sectional?”
  • “Classify the design used in this immunotherapy biomarker paper.”
  • “This paper says it is real-world evidence. Is that actually true from the methods?”
  • “Identify whether this study is RCT, case-control, retrospective cohort, or registry analysis.”
  • “This paper combines GEO screening, TCGA validation, and mouse experiments — what is the real design?”
  • “Separate the clinical design and the experimental design in this hybrid paper.”

Core Function

This skill must identify study design from what the study actually did, not from what the title, keywords, or author summary claims.

The classification must distinguish among major families such as:

  • randomized controlled trial
  • non-randomized interventional study
  • prospective cohort
  • retrospective cohort
  • case-control study
  • cross-sectional study
  • registry/database study
  • real-world evidence study
  • diagnostic accuracy study
  • prognostic model / prediction study
  • systematic review / meta-analysis
  • omics screening study
  • mechanism experiment
  • hybrid multi-layer study

When a paper contains multiple evidence layers, this skill must identify:

  • Primary design = the layer that carries the main claim
  • Secondary design = supportive but non-dominant layer
  • Hybrid status = whether the paper should be treated as multi-design rather than forced into one oversimplified label

Execution — 8 Steps (always run in order)

Step 1 — Identify the Unit of Classification

Determine whether the input is:

  • a single paper
  • a study summary
  • a partial paper segment such as abstract or methods
  • a hybrid paper containing multiple design layers

State whether the available material is sufficient for high-confidence classification.

Step 2 — Extract Design-Relevant Signals

Before assigning a label, identify:

  • population or model system
  • intervention or exposure structure
  • comparator logic
  • sampling logic
  • temporal direction
  • outcome timing
  • data source type
  • validation structure
  • experimental versus observational components

Do not classify from keywords alone.

Step 3 — Map to the Study Design Taxonomy

Use references/study-design-taxonomy.md.

Assign the closest valid design family based on actual structure, not author wording.

Required distinction examples:

  • retrospective cohort vs case-control
  • cross-sectional vs longitudinal cohort
  • registry/database analysis vs true real-world evidence framing
  • diagnostic study vs prognostic study
  • omics screening vs mechanistic validation study
  • exploratory biomarker discovery vs validated prediction model study
Step 4 — Check for Hybrid or Layered Design

Use references/design-decision-rules.md and references/edge-case-handling.md.

If the paper contains multiple central components, separate them rather than collapsing them into one vague label.

Common hybrid examples:

  • clinical cohort + biomarker assay validation
  • public omics screening + wet-lab experiments
  • retrospective dataset model building + external validation cohort
  • observational clinical data + mechanistic animal work
Step 5 — Correct Misleading Self-Labels

If the paper's own label appears imprecise, incomplete, or inflated, correct it explicitly.

Examples:

  • a study calling itself “real-world” that is actually a single-center retrospective cohort
  • a study described as “prospective” when the analysis structure is retrospective
  • a paper described as “mechanism study” when it is mainly expression association plus limited perturbation evidence
Step 6 — Assign Evidence-Family Position

Use references/evidence-grading-bridge.md.

State where the design sits in literature appraisal terms:

  • interventional
  • observational
  • diagnostic/prognostic
  • computational/omics
  • experimental/mechanistic
  • synthesis-level evidence
  • hybrid evidence chain

This step must support downstream evidence grading, not replace it.

Show full SKILL.md (596 more words)Show less
Step 7 — Rate Classification Confidence

Classify confidence as High / Medium / Low based on:

  • clarity of the methods
  • completeness of the available text
  • whether the design is standard or mixed
  • whether timing and comparison structure are explicit
  • whether the paper uses misleading terminology
Step 8 — Perform a Short Self-Check

Before finalizing, explicitly check:

  • strongest basis for the design label
  • biggest ambiguity that could change the label
  • whether a hybrid label is more honest than a single label
  • whether the paper's own terminology may mislead the reader

Mandatory Output Structure

A. Input Scope and Classification Readiness

State what material was provided and whether it is sufficient for high-confidence design identification.

B. Design-Relevant Signals Extracted

Summarize the key structural features used for classification:

  • population/model
  • exposure or intervention
  • comparison logic
  • timing direction
  • data source
  • validation structure
  • experimental vs observational components
C. Primary Study Design Label

State the best-fit main design label and explain why it fits.

D. Secondary Design or Hybrid Components

If applicable, identify secondary design layers and whether the study should be treated as hybrid.

E. What the Study Is Not

State the nearest confusing alternatives and why they do not fit.

F. Evidence-Family Position

Place the study into an evidence family suitable for literature appraisal and evidence grading.

G. Classification Confidence

Give High / Medium / Low confidence with brief justification.

H. Short Design Appraisal Note

State what this design can usually support and what it cannot support by itself.

I. Citation / Source Note

If a formal paper citation is given, include it only when the metadata has been directly verified from the provided material or a validated source. Otherwise keep the classification content-focused and do not invent metadata.


Hard Rules

  1. Identify study design from actual methods and structure, not from title keywords or author self-label alone.
  2. Do not force a hybrid paper into a single oversimplified label when multiple design layers are central.
  3. Distinguish retrospective cohort, prospective cohort, case-control, and cross-sectional designs carefully every time.
  4. Distinguish observational association studies from mechanistic experiments every time.
  5. Distinguish exploratory omics screening from validated clinical prediction or biomarker studies every time.
  6. Do not equate registry/database analysis with strong real-world evidence automatically.
  7. Do not treat external validation, functional validation, or secondary experiments as proof that the main design has changed category.
  8. If methods are incomplete, lower confidence rather than pretending certainty.
  9. Never fabricate references, PMIDs, DOIs, author names, journal names, publication years, trial identifiers, or study features.
  10. If metadata cannot be verified, do not present it as a formal citation.
  11. If the paper's own terminology is inaccurate, say so plainly and give the corrected design label.
  12. When the design remains ambiguous, present the most likely classification plus the key unresolved ambiguity rather than inventing missing details.

What This Skill Should Not Do

Do not:

  • summarize the whole paper as if this were a literature reading skill
  • judge therapeutic efficacy beyond what the design can support
  • treat “real-world,” “prospective,” or “mechanistic” as trustworthy labels without structural confirmation
  • confuse data type with study design
  • classify a paper only by assay names, software, or dataset brand names
  • invent methods that were not stated
  • inflate evidence level because a paper looks complex or uses many techniques

Quality Standard

A high-quality output from this skill should feel like a design-identification memo, not a generic summary.

The user should be able to see:

  • what structural features determined the label,
  • why similar alternative designs were rejected,
  • whether the study is single-design or hybrid,
  • and how the final label should be used in later literature appraisal or evidence grading.

© 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 7 other files (references) in awesome-med-research-skills/Evidence Insight/study-design-identifier of aipoch/medical-research-skills.

  • SKILL.md
  • eval_report_study-design-identifier_result.json
  • references/design-decision-rules.md
  • references/edge-case-handling.md
  • references/evidence-grading-bridge.md
  • references/output-section-guidance.md
  • references/study-design-taxonomy.md
  • references/workflow-step-template.md

Open the folder on GitHubat commit 686e09d

Compare with similar skills

Study Design Identifier 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.

Study Design Identifier compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Study Design Identifier this skillaipoch/medical-research-skills2k—~3kAutomated safety check: PassMIT
Scientific Critical Thinkingweapp-tailwindcss/weapp-tailwindcss1.9k23 repos~5.9kAutomated safety check: NotesMIT
Claim-Driven Experiment PlannerzjYao36/Auto-Research-Refine1287 repos~2.3kAutomated safety check: NotesNone
Benchmark Paper TemplateHKUSTDial/Supervisor-Skills8.5k—~2.8kAutomated safety check: PassCC-BY-4.0
Research Refine PipelinezjYao36/Auto-Research-Refine1286 repos~1.4kAutomated safety check: NotesNone
Metabolic Study Planneraiming-lab/AutoResearchClaw15k—~1.9kAutomated safety check: PassMIT

Similar skills

  • Scientific Critical Thinking

    weapp-tailwindcss/weapp-tailwindcss

    Evaluate research rigor. An agent skill from weapp-tailwindcss/weapp-tailwindcss.

    1.9k GitHub starsUsed in 23 repos~5.9k tokens
    Research & ScienceAuto-check: notes
  • Claim-Driven Experiment Planner

    zjYao36/Auto-Research-Refine

    Turns a refined research proposal into a claim-to-evidence-to-run-order roadmap instead of a sprawling benchmark wishlist.

    128 GitHub starsUsed in 7 repos~2.3k tokens
    Research & ScienceAuto-check: notes
  • Benchmark Paper Template

    HKUSTDial/Supervisor-Skills

    Structures benchmark and evaluation papers around five pillars, with a completeness audit, an Introduction logic chain, a section skeleton and a pre-submission checklist.

    8.5k GitHub stars~2.8k tokensUpdated 1 mo ago
    Research & ScienceAuto-check passed
  • Research Refine Pipeline

    zjYao36/Auto-Research-Refine

    Chains research-refine and experiment-plan to turn a vague research direction into a focused proposal and a claim-driven experiment roadmap.

    128 GitHub starsUsed in 6 repos~1.4k tokens
    Research & ScienceAuto-check: notes
  • Metabolic Study Planner

    aiming-lab/AutoResearchClaw

    Turns a broad metabolic modelling topic into a concrete, paper-shaped plan with organism, model, perturbations, metrics and figures before any FBA code is written.

    15k GitHub stars~1.9k tokensUpdated 1 mo ago
    Research & ScienceAuto-check passed
  • Experimental Design

    Oleafly/Oleafly

    Design experiments and studies BEFORE data is collected — choosing a design, randomizing, blocking, and laying out treatment combinations so results are interpretable.

    206 GitHub starsUsed in 4 repos~3.5k 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 21 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 21 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 21 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 21 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 21 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 21 days ago
    Auto-check passed

Questions about Study Design Identifier

What does Study Design Identifier do?

Identifies the real underlying study design used in a medical or biomedical paper, distinguishes primary and secondary design components when papers are hybrid, and converts the paper into an…. Study Design Identifier is an agent skill from aipoch/medical-research-skills. Identifies the real underlying study design used in a medical or biomedical paper, distinguishes primary and secondary design components when papers are hybrid, and converts the paper into an evidence-aware design label suitable for literature appraisal, evidence grading, and downstream review workflows.

When should I use Study Design Identifier?

Study Design Identifier fits situations like: tasks that involve Experimental design.

How do I install Study Design Identifier in Claude Code?

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

How do I install Study Design Identifier in Codex?

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

Can I use Study Design Identifier 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 study-design-identifier -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/study-design-identifier, .gemini/skills/study-design-identifier, .github/skills/study-design-identifier and .opencode/skills/study-design-identifier in your project.

What does Study Design Identifier need to run?

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

Does Study Design Identifier 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 Study Design Identifier 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 Study Design Identifier use?

Study Design Identifier 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 Study Design Identifier use?

About 3k tokens (SKILL.md is roughly 12k 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 929 tokens, read only when the agent opens those files.

What are the alternatives to Study Design Identifier?

Skills that share tags, products or a category with Study Design Identifier: Scientific Critical Thinking (weapp-tailwindcss/weapp-tailwindcss, 1.9k stars), Claim-Driven Experiment Planner (zjYao36/Auto-Research-Refine, 128 stars), Benchmark Paper Template (HKUSTDial/Supervisor-Skills, 8.5k stars) and Research Refine Pipeline (zjYao36/Auto-Research-Refine, 128 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Study Design Identifier?

aipoch (a GitHub organization) maintains it in aipoch/medical-research-skills, which has 1,974 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.