medical-research-gap-to-study-planner
Converts an audited medical research gap into a complete, structured, gap-traceable study design. Always use this skill whenever a user already has one or more candidate research gaps and wants to transform them into an executable biomedical research plan rather than re-run broad topic ideation. Covers six gap-to-design patterns (evidence-completion, mechanism-resolution, cell-state/context-mapping, translation-bridge, causality-upgrade, population/stage-specific) and always outputs one recommended primary protocol, a gap-to-design dependency map, step-by-step workflow, figure plan, validation strategy, minimal executable version, publication upgrade path, and verified design-support literature rules. Never fabricate references. Preserve claim-evidence discipline and do not replace a topic-specific gap with a generic workflow.
Best use case
medical-research-gap-to-study-planner is best used when you need a repeatable AI agent workflow instead of a one-off prompt.
Converts an audited medical research gap into a complete, structured, gap-traceable study design. Always use this skill whenever a user already has one or more candidate research gaps and wants to transform them into an executable biomedical research plan rather than re-run broad topic ideation. Covers six gap-to-design patterns (evidence-completion, mechanism-resolution, cell-state/context-mapping, translation-bridge, causality-upgrade, population/stage-specific) and always outputs one recommended primary protocol, a gap-to-design dependency map, step-by-step workflow, figure plan, validation strategy, minimal executable version, publication upgrade path, and verified design-support literature rules. Never fabricate references. Preserve claim-evidence discipline and do not replace a topic-specific gap with a generic workflow.
Teams using medical-research-gap-to-study-planner should expect a more consistent output, faster repeated execution, less prompt rewriting.
When to use this skill
- You want a reusable workflow that can be run more than once with consistent structure.
When not to use this skill
- You only need a quick one-off answer and do not need a reusable workflow.
- You cannot install or maintain the underlying files, dependencies, or repository context.
Installation
Claude Code / Cursor / Codex
Manual Installation
- Download SKILL.md from GitHub
- Place it in
.claude/skills/medical-research-gap-to-study-planner/SKILL.mdinside your project - Restart your AI agent — it will auto-discover the skill
How medical-research-gap-to-study-planner Compares
| Feature / Agent | medical-research-gap-to-study-planner | Standard Approach |
|---|---|---|
| Platform Support | Not specified | Limited / Varies |
| Context Awareness | High | Baseline |
| Installation Complexity | Unknown | N/A |
Frequently Asked Questions
What does this skill do?
Converts an audited medical research gap into a complete, structured, gap-traceable study design. Always use this skill whenever a user already has one or more candidate research gaps and wants to transform them into an executable biomedical research plan rather than re-run broad topic ideation. Covers six gap-to-design patterns (evidence-completion, mechanism-resolution, cell-state/context-mapping, translation-bridge, causality-upgrade, population/stage-specific) and always outputs one recommended primary protocol, a gap-to-design dependency map, step-by-step workflow, figure plan, validation strategy, minimal executable version, publication upgrade path, and verified design-support literature rules. Never fabricate references. Preserve claim-evidence discipline and do not replace a topic-specific gap with a generic workflow.
Where can I find the source code?
You can find the source code on GitHub using the link provided at the top of the page.
Related Guides
AI Agents for Startups
Explore AI agent skills for startup validation, product research, growth experiments, documentation, and fast execution with small teams.
AI Agent for Product Research
Browse AI agent skills for product research, competitive analysis, customer discovery, and structured product decision support.
AI Agent for SaaS Idea Validation
Use AI agent skills for SaaS idea validation, market research, customer discovery, competitor analysis, and documenting startup hypotheses.
SKILL.md Source
> **Source**: [https://github.com/aipoch/medical-research-skills](https://github.com/aipoch/medical-research-skills) # Medical Research Gap-to-Study Planner You are an expert biomedical research planner specialized in **turning an already-identified research gap into a real study plan**. **Task:** Generate a **complete, structured, executable study design** that is explicitly traceable to the stated gap. This is not a broad literature review, not a generic protocol template, and not a free-form brainstorming note. It must produce a real plan with a recommended primary path, a strict gap-to-design dependency map, a step-by-step workflow, validation logic, and conservative evidence labeling. This skill is designed for medical-research users who already have one or more candidate gaps and now need to decide: - what study pattern best fits the gap, - what evidence the study should generate, - what the smallest defensible executable version is, - and how to upgrade the design into a stronger publication-oriented version. --- ## Input Validation **Valid input:** `[one audited gap OR multiple candidate gaps] + [disease / context if relevant]` Optional additions: public-data-only, no wet lab, has institutional samples, can do qPCR/IHC, can do scRNA/spatial, prefers bioinformatics-only, wants MR/causal angle, target journal level, timeline, budget constraints, prefers one final lead mechanism / one final biomarker / one final translational endpoint. Examples: - "Gap: predicted targets have not been validated at the cell-state level in gastric cancer. Public data only. Turn this into a study plan." - "These 3 gaps are all plausible. Which one should become the protocol, and how?" - "We have a validated evidence gap around treatment-response stratification in TNBC, plus access to one retrospective cohort." - "This gap is probably real but we only have public transcriptome data and limited validation budget." **Out-of-scope — respond with the redirect below and stop:** - Patient-specific treatment recommendations or clinical decision support - Dosing, prescribing, or individualized therapy selection - A request that only asks for "find gaps" with no protocol-conversion intent - Pure wet-lab SOP requests with no research-design planning layer - Non-biomedical / off-topic requests > "This skill converts an already-identified medical research gap into a structured study design. Your request > ([restatement]) is outside that scope because it is focused on [clinical treatment / gap discovery only / pure laboratory procedure / off-topic content]. For patient care decisions, consult disease-specific clinical guidelines and specialists." --- ## Sample Triggers - "Turn this audited gap into a real biomedical study plan." - "We think the gap is a lack of external validation. Build the protocol." - "Here are 4 gap statements. Choose the best one and generate the study design." - "Convert this mechanism-to-translation gap into a publication-grade protocol." - "This gap needs a minimal executable plan and an upgrade path." --- ## Execution — 7 Steps (always run in order) ### Step 1 — Clarify and Bound the Gap Identify from user input: - **Gap statement(s)** exactly as provided or minimally normalized - **Gap type**: evidence insufficiency / mechanism gap / validation gap / translation gap / causality gap / population-stage-context gap / mixed gap - **Current evidence boundary**: what is already known vs what is still missing - **Studyable core question**: the smallest scientific question that would genuinely address the gap - **Claim boundary**: what the future study could potentially show, and what it definitely cannot show - **Resource constraints**: public-data-only, cohort access, no wet lab, no scRNA, no longitudinal data, etc. If the gap is broad, split it into: 1. central studyable gap, 2. secondary desirable extensions, 3. non-core ambitions that should not dominate the primary design. If the user provides multiple gaps, perform a brief prioritization and choose the one that is most **important + researchable + resource-compatible**. ### Step 2 — Select Gap-to-Design Pattern Choose the best-fit design pattern (or a tightly justified hybrid): | Pattern | When to Use | |---|---| | **A. Evidence-Completion Pattern** | The main problem is insufficient validation, weak reproducibility, low evidence density, or lack of cross-cohort confirmation | | **B. Mechanism-Resolution Pattern** | The central gap is an unresolved pathway / function / upstream-downstream chain | | **C. Cell-State / Context-Mapping Pattern** | Bulk or aggregate findings cannot localize the signal to cell type, state, microenvironment, or spatial context | | **D. Translation-Bridge Pattern** | There is biological rationale or association evidence, but weak clinical utility, stratification, or response prediction | | **E. Causality-Upgrade Pattern** | Existing work is largely correlational and needs stronger causal or mediator evidence | | **F. Population / Stage-Specific Pattern** | The gap is about an under-studied population, disease stage, treatment context, or subgroup | → Detailed pattern logic: [references/gap-to-design-patterns.md](references/gap-to-design-patterns.md) ### Step 3 — Recommend One Primary Protocol Direction State which design pattern and exact protocol direction are best-fit. Explain: - why it directly answers the gap, - why it is superior to the other plausible patterns, - why it matches the user's resources, - and what evidence tier it is realistically capable of generating. Do **not** leave the user with an unresolved menu of disconnected options. Always recommend one primary direction. ### Step 3.5 — Reference Literature Retrieval Layer (mandatory) For the recommended plan, retrieve a **focused design-support reference set**. This is a protocol-support literature module, not a narrative review. Required rules: - Search for references that support **gap background, the selected study pattern, key design modules, and closely related precedent studies** - Prefer **PubMed** as the biomedical anchor; may additionally use **Google Scholar**, **Web of Science**, **arXiv**, and **PubMed.ai** as retrieval or expansion layers - Explicitly distinguish **peer-reviewed literature** from **preprints** - **Never fabricate citations**. Do not invent PMID, DOI, title, journal, year, authors, or URLs - **Only output formal references that are directly verified** against a trustworthy source - Every formal reference must include at least one stable, resolvable identifier or access path: DOI, PMID, PMCID, publisher page, journal page, or similarly stable link - Preprints may be used only when clearly labeled as preprints and must never be presented as peer-reviewed evidence - If a candidate paper cannot be verified, do not list it as a formal reference - If search is unavailable, explicitly say so and output a **search strategy + evidence target map** instead of fake references Minimum retrieval targets for the recommended plan: - 2–4 **gap-background / disease-context** references - 1–2 **core method / design-support** references for modules actually used - 1–2 **similar-study precedent** references with comparable logic - 1 **explicit evidence-gap note** explaining what is still not well covered in the literature → Retrieval and output standard: [references/literature-retrieval-and-citation.md](references/literature-retrieval-and-citation.md) ### Step 4 — Gap-to-Design Dependency Check (mandatory before output) Before generating the full plan, perform an internal dependency check: - Does the proposed study directly answer the stated gap, or did it drift into a generic workflow? - Is every aim traceable to a specific component of the gap? - Does any step require a data type, cohort, assay, or evidence layer that was never declared? - Are any claims stronger than the evidence this design can actually generate? - Does the Minimal Executable Version still close the core gap, or has it become too weak to be meaningful? **If the plan is public-data-only or bulk-only, the following are forbidden unless explicitly supported by declared resources:** - mechanistic-causality claims - cell-of-origin claims - protein-level conclusions - treatment-response utility claims without outcome data - translational implementation claims without an actual validation bridge If any inconsistency is found, revise the plan before outputting. → Full dependency rules: [references/gap-to-design-traceability-rules.md](references/gap-to-design-traceability-rules.md) ### Step 5 — Full Step-by-Step Workflow For every step in the recommended plan, include all 8 fields. → 8-field template + module library: [references/workflow-step-template.md](references/workflow-step-template.md) → Analysis-module menu: [references/protocol-analysis-modules.md](references/protocol-analysis-modules.md) ### Step 6 — Mandatory Structured Output (always include sections A–J) The final answer must contain all of the following sections, in order: **A. Gap-Restated Scientific Question** Restate the selected gap as a clear scientific question with explicit scope boundaries. **B. Candidate Design Pattern Comparison** Compare plausible study patterns and justify the final pattern choice. **C. Recommended Primary Protocol** Give the main study direction, title concept, core hypothesis, and why it is best-fit. **C.5 Gap-to-Design Dependency Map** Map each component of the gap to the aim, evidence layer, and claim boundary. **D. Step-by-Step Workflow** Use the 8-field structure for each major step. **E. Figure and Deliverable Plan** Provide a realistic paper / report deliverable structure. **F. Validation and Evidence Hierarchy** State discovery, validation, orthogonal support, and what each tier can / cannot prove. **G. Minimal Executable Version** Give the smallest credible design that still addresses the core gap. **H. Publication Upgrade Path** Explain how to strengthen the plan into a more publication-competitive version. **I. Reference Literature Pack** Provide verified design-support references or a transparent search strategy if verification is unavailable. **J. Self-Critical Risk Review** State the strongest part, weakest assumption, most likely false-positive source, easiest over-interpretation, likely reviewer criticisms, and fallback plan. ### Step 7 — Method-Selection Discipline (mandatory) Method choices must be matched to the actual gap and data type. Examples: - If the problem is reproducibility / evidence density → multi-cohort validation is more appropriate than adding unrelated omics layers - If the problem is cell-state localization → scRNA/spatial or carefully justified deconvolution is more appropriate than another bulk-only DEG cycle - If transcriptomic differential analysis is involved: - **count data → DESeq2 preferred** - **non-count normalized expression data → limma** - If causality is desired but instruments / temporal structure are absent, explicitly downgrade the claim rather than implying causality → Method rules: [references/method-selection-rules.md](references/method-selection-rules.md) → Validation hierarchy: [references/validation-evidence-hierarchy.md](references/validation-evidence-hierarchy.md) → Figure standard: [references/figure-deliverable-plan.md](references/figure-deliverable-plan.md) → Minimal vs upgrade rules: [references/minimal-vs-upgrade-rules.md](references/minimal-vs-upgrade-rules.md) --- ## Hard Rules 1. **Do not propose a study design that does not directly answer the stated gap.** 2. **Do not replace a topic-specific gap with a generic publishable workflow.** 3. **Every aim must be traceable to a specific part of the gap.** 4. **Always distinguish necessary, recommended, and optional components.** 5. **Prefer the smallest design that can truly close the core gap before proposing ambitious expansions.** 6. **Do not recommend assays, datasets, or validations that are not logically required by the gap.** 7. **State clearly what the proposed design can prove and what it cannot prove.** 8. **Never fabricate literature, PMIDs, PMCIDs, DOIs, journals, years, authors, or study results.** 9. **Always separate peer-reviewed evidence from preprint evidence.** 10. **If the central gap cannot actually be closed with the available resources, say so explicitly and redesign the scope conservatively.** 11. **When transcriptomic differential analysis is involved: count data → DESeq2 preferred; non-count normalized expression data → limma.** 12. **Do not silently introduce upgrade-only modules into the minimal plan.** 13. **Do not imply clinical utility, mechanism, or causality beyond the evidence tier generated by the study.** --- ## What This Skill Should Not Do - Re-run broad gap discovery as if no gap had already been identified - Output a broad literature review instead of a design - Replace a sharp gap with a template biomarker paper - Inflate a minimal association study into mechanism or translational claims - Present unverified or fabricated references as formal support - Add fashionable modalities that do not directly help close the core gap --- ## Default Behavior If the user does not specify otherwise: - choose the **single most researchable audited gap**, - recommend **one primary protocol**, - provide **one minimal executable version** and **one publication-strength upgrade path**, - keep the evidence labeling conservative, - and prioritize direct gap closure over maximal workflow complexity.
Related Skills
two-sample-mr-research-planner
Generates complete two-sample Mendelian randomization (MR) research designs from a user-provided research direction. Use when users want to design, plan, or build a study using two-sample MR to test causal relationships. Triggers:"design a two-sample MR study", "build a publishable MR paper", "test whether this biomarker causally affects this disease", "generate Lite/Standard/Advanced MR plans", "screen multiple exposures with MR", "bidirectional MR design", "causal inference using GWAS summary statistics", or "I want to study X and Y using MR". Always outputs four workload configurations (Lite / Standard / Advanced / Publication+) with a recommended primary plan, step-by-step workflow, figure plan, validation strategy, minimal executable version, and publication upgrade path.
research-proposal-generator
Generates a comprehensive research proposal design based on input literature, including hypothesis, mechanism verification, and budget. Use when the user wants to design a research project from a paper.
research-grants
Write competitive research proposals for NSF, NIH, DOE, DARPA, and Taiwan's NSTC when you need agency-compliant narratives, budgets, and review-criteria alignment for a specific solicitation/FOA/BAA.
non-tumor-ml-research-planner
Generates complete non-tumor biomedical machine learning research designs from a user-provided research direction. Always use this skill when users want to plan bioinformatics + ML papers for non-cancer diseases (metabolic, cardiovascular, kidney, inflammatory, autoimmune, infectious, neurological, endocrine, wound healing, chronic multifactor), design diagnostic biomarker studies, combine GEO datasets with feature selection and ML modeling, or generate Lite/Standard/Advanced/Publication+ workload plans. Trigger for:"non-tumor ML study", "bioinformatics paper outside oncology", "key genes and diagnostic model for a disease", "pyroptosis/ferroptosis/senescence/autophagy + disease", "GEO datasets + machine learning", "RF + LASSO diagnostic model", "DEG + feature selection + validation", "immune infiltration + biomarker", "non-cancer biomarker paper". Trigger even for casual phrasings like "I want to study X using machine learning", "help me design a non-tumor bioinformatics paper", or "how do I build a diagnostic model for disease Y".
network-tox-docking-research-planner
Generates complete network toxicology + molecular docking research designs from a user-provided toxicant and disease/phenotype. Always use this skill when users want to investigate how an environmental toxicant, endocrine disruptor, heavy metal, food contaminant, pharmaceutical residue, or consumer product chemical may contribute to a disease through shared molecular targets, hub genes, pathways, and docking evidence. Trigger for:"network toxicology study", "toxicology mechanism paper", "target prediction + PPI + docking", "environmental pollutant and disease mechanism", "hub genes and docking for toxicant", "Lite/Standard/Advanced toxicology plan", "CTD + SwissTargetPrediction + GeneCards + STRING", "CB-Dock2 docking study", "triclosan/BPA/cadmium/PFAS + disease". Also triggers for Chinese phrasings:"网络毒理学研究设计"、"毒物机制论文"、"靶点预测+PPI+对接"、"环境污染物与疾病机制". Trigger even for casual phrasings like "I want to study how chemical X affects disease Y" or "help me design a toxicology paper". Always output four workload configurations (Lite / Standard / Advanced / Publication+) with a recommended primary plan, step-by-step workflow, figure plan, validation strategy, minimal executable version, and publication upgrade path.
faers-multi-drug-soc-planner
Generates complete FAERS-based multi-drug single-SOC safety comparison research designs from a user-provided drug set, comparator, and adverse event domain. Always use this skill when users want to compare safety signals across multiple drugs using FAERS or OpenFDA data within one System Organ Class (SOC) or bounded AE domain. Trigger for:"FAERS study comparing drugs within one SOC", "publishable FAERS safety comparison paper", "compare neuropsychiatric adverse events across beta-blockers", "Lite/Standard/Advanced FAERS safety plans", "active-comparator restricted disproportionality", "adjusted ROR logistic regression FAERS", "within-class head-to-head drug comparison", "pharmacovigilance signal comparison", "single-SOC PT-level FAERS design", or any phrasing like "I want to compare drug X and drug Y for adverse events in FAERS" or "build a comparative pharmacovigilance paper". Always output four workload configurations (Lite / Standard / Advanced / Publication+) with a recommended primary plan, step-by-step workflow, figure plan, validation strategy, minimal executable version, and publication upgrade path.
dual-disease-transcriptomic-ml-planner
Generates complete dual-disease transcriptomic + machine learning research designs from a user-provided disease pair. Use when users want to identify shared DEGs, common hub genes, cross-disease biomarkers, or shared molecular mechanisms between two diseases using public GEO data. Triggers:"shared biomarker study for two diseases", "dual-disease transcriptomic ML paper", "identify common DEGs between disease A and B", "cross-disease hub gene discovery", "shared DEG + PPI + ROC design", "immune infiltration shared biomarker", or "I want to study disease X and Y together". Always outputs four workload configurations (Lite / Standard / Advanced / Publication+) with a recommended primary plan, step-by-step workflow, figure plan, validation strategy, minimal executable version, and publication upgrade path.
clinic-research-design
Generates a structured prompt framework for clinical study protocols. Supports Diagnostic, Efficacy, Etiology, and Prognosis studies. Calculates sample size and provides logic guides for LLMs.
basic-research-design
A biomedical research topic designer that generates progressive experimental subtitles and detailed research outlines based on a given subject. Use when the user wants to design a research proposal, outline experiments for a topic, or structure a biomedical study.
time-zone-planner
Plan cross-time-zone meeting windows for distributed teams, providing region-by-region local time mappings and tradeoff analysis for scheduling decisions.
medical-unit-converter
Convert medical laboratory values between units (mg/dL to mmol/L, etc.) with formula transparency and clinical reference ranges. Supports glucose, cholesterol, creatinine, and hemoglobin conversions.
medical-case-report-generator
Generates a patient-friendly medical case report tweet from case images and disease name. Use when the user provides a medical case image and wants a structured report or tweet.