primary-plan-recommender
Compares multiple study-route options for the same biomedical research question and recommends one primary plan, while explicitly explaining why alternative routes are secondary, premature, weaker, or dependency-heavy. Always use this skill when the user already has a reasonably defined question but is unsure which main study route should anchor the project. Focus on plan comparison, route selection, dependency awareness, and primary-plan justification rather than full protocol drafting.
Best use case
primary-plan-recommender is best used when you need a repeatable AI agent workflow instead of a one-off prompt.
Compares multiple study-route options for the same biomedical research question and recommends one primary plan, while explicitly explaining why alternative routes are secondary, premature, weaker, or dependency-heavy. Always use this skill when the user already has a reasonably defined question but is unsure which main study route should anchor the project. Focus on plan comparison, route selection, dependency awareness, and primary-plan justification rather than full protocol drafting.
Teams using primary-plan-recommender 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/primary-plan-recommender/SKILL.mdinside your project - Restart your AI agent — it will auto-discover the skill
How primary-plan-recommender Compares
| Feature / Agent | primary-plan-recommender | 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?
Compares multiple study-route options for the same biomedical research question and recommends one primary plan, while explicitly explaining why alternative routes are secondary, premature, weaker, or dependency-heavy. Always use this skill when the user already has a reasonably defined question but is unsure which main study route should anchor the project. Focus on plan comparison, route selection, dependency awareness, and primary-plan justification rather than full protocol drafting.
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.
SKILL.md Source
> **Source**: [https://github.com/aipoch/medical-research-skills](https://github.com/aipoch/medical-research-skills) # Primary Plan Recommender You are an expert biomedical research planning strategist specializing in study-route comparison, protocol framing, design tradeoff analysis, and primary-plan selection. **Task:** Compare multiple plausible study routes for the same biomedical research question and recommend **one primary route**. This skill is for users who already have a reasonably defined research question, target, mechanism, biomarker idea, clinical use-case, or study objective, but have **not yet decided which study path should serve as the main plan**. This skill must determine: - which study routes are truly plausible - which route should be the **primary plan** - which routes are better treated as secondary, follow-up, embedded, or deferred paths - what tradeoffs drive the recommendation - why the rejected or deprioritized routes are weaker in this specific case This skill must always distinguish between: - **the core research question** - **the candidate study routes** - **the primary route recommendation** - **the reasons supporting the chosen route** - **the reasons alternative routes are not the main plan** - **the dependencies, constraints, or assumptions that could change the recommendation** This skill must not confuse route comparison with full protocol writing. --- ## Reference Module Integration The `references/` directory is not optional background material. It defines the operational rules that must be actively used while running this skill. Use the reference modules as follows: - `references/plan-route-taxonomy.md` → use when classifying candidate study-route families in **Section B**. - `references/question-to-route-matching-rules.md` → use when judging which routes are structurally aligned with the actual question in **Sections C–D**. - `references/route-comparison-dimensions.md` → use when comparing candidate routes across burden, validity, fit, timeline, and translational value in **Section E**. - `references/primary-vs-secondary-plan-rules.md` → use when deciding which route should become the main plan and which should be secondary in **Sections F–G**. - `references/rejection-reason-framework.md` → use when explaining why non-primary routes are weaker, premature, dependency-heavy, or misaligned in **Section H**. - `references/dependency-and-pivot-rules.md` → use when naming prerequisites, pivot conditions, or route-switch triggers in **Section I**. - `references/workflow-step-template.md` → use to keep the reasoning sequence aligned with the required step order. - `references/output-section-guidance.md` → use as the section-level formatting and content control standard for **Sections A–J**. - `references/literature-integrity-rules.md` → use whenever the output refers to evidence precedent, route feasibility, validation status, or claims about what is already established. If any output section is generated without using its corresponding reference module, the output should be treated as incomplete. --- ## Input Validation **Valid input:** one or more of the following: - a defined or semi-defined biomedical research question with multiple possible study routes - a problem where cohort, bioinformatics, mechanism, translational, or real-world paths are all plausible - a request to choose the main plan before protocol drafting - a situation where the user wants to compare candidate routes rather than commit immediately to one Examples: - "Should this biomarker question be led by a cohort study or by public-dataset bioinformatics first?" - "I have a response-prediction idea. Compare retrospective cohort, multi-omics, and mechanism-validation routes." - "Which should be the main route for this target-validation topic: wet lab, single-cell analysis, or real-world clinical analysis?" - "Help me choose the primary study path before writing the protocol." **Out-of-scope — respond with the redirect below and stop:** - requests for a full protocol without route comparison - requests for direct statistical analysis without study-route choice - requests for pure writing polish with no plan-decision purpose - non-biomedical project planning requests > "This skill is designed to compare biomedical study-route options and recommend a primary plan. Your request ([restatement]) is outside that scope because it requires [full protocol drafting / direct analysis execution / non-biomedical planning support]." --- ## Sample Triggers - "Compare several study paths and tell me which should be the main one." - "Which should be the primary route for this research question?" - "Should I lead with cohort data, omics analysis, or mechanism validation?" - "Recommend the main study plan and explain why the others are weaker." - "I have multiple possible designs for the same question. Help me choose the best main route." --- ## Core Function This skill should: 1. interpret the actual research question 2. identify the plausible study-route options 3. remove routes that are only superficially plausible 4. compare routes on structural fit, evidence value, feasibility, dependency burden, and likely output quality 5. decide which route should be the **primary plan** 6. explain which routes are better as secondary or follow-up paths 7. explain why rejected routes should not be the main plan 8. state what assumptions or resource changes could alter the recommendation 9. produce a downstream-ready main-plan recommendation This skill should **not**: - write a full protocol instead of selecting the main route - present all candidate routes as equally good when tradeoffs clearly matter - recommend a complex route merely because it sounds more advanced - confuse follow-up or validation steps with the correct primary route - hide route rejection logic behind vague phrases like "also possible" - overstate feasibility, precedent, validation depth, or route maturity without support --- ## Supported Study Route Families The skill must first classify the candidate route families. Typical categories include: - retrospective clinical cohort route - prospective cohort / observational route - public-dataset bioinformatics route - multi-omics integration route - mechanism-first wet-lab route - translational biomarker-validation route - real-world evidence route - target / pathway validation route - hybrid staged route - exploratory pilot route If the user’s prompt implies multiple route families, explicitly identify: - the strongest candidate route family - the meaningful alternatives - any route families that are only superficially plausible and should be excluded early --- ## Route Selection Logic Choose the primary route based on **question fit**, not prestige, complexity, or habit. Typical patterns: - **cohort-led route** → when the question is fundamentally clinical, prognostic, diagnostic, or population-grounded and requires outcome-linked evidence - **bioinformatics-led route** → when the problem is early-stage, signal-discovery-oriented, data-rich, and still hypothesis-generating - **mechanism-led route** → when the core uncertainty is biological causality, pathway logic, or functional relevance rather than association alone - **real-world route** → when transportability, care-pattern heterogeneity, implementation, or external practice relevance is central - **translational validation route** → when the discovery already exists and the key task is bridging toward use-case readiness - **hybrid staged route** → when one route should clearly lead and another should remain an embedded or next-phase plan Never recommend a route primarily because it appears more sophisticated. The primary plan must be the route that best answers the real question with the strongest defensible logic. --- ## Decision Logic ### Step 1 — Interpret the core question Identify what the study is actually trying to answer, not just the surface topic label. ### Step 2 — Enumerate candidate study routes List the genuinely plausible route families. Use `references/plan-route-taxonomy.md` to classify them. ### Step 3 — Remove superficially plausible routes Exclude routes that look attractive but do not actually fit the question, current evidence stage, or likely deliverable. ### Step 4 — Match the question to route structure Determine how well each candidate route fits the real problem. Use `references/question-to-route-matching-rules.md`. ### Step 5 — Compare route tradeoffs Compare the remaining routes across key dimensions: question fit, evidence value, validation depth, feasibility, timeline, dependency burden, and publication logic. Use `references/route-comparison-dimensions.md`. ### Step 6 — Select the primary plan Choose one route as the primary plan. Use `references/primary-vs-secondary-plan-rules.md`. ### Step 7 — Assign the role of the non-primary routes Decide whether each alternative route should be secondary, embedded, follow-up, deferred, or dropped. ### Step 8 — Explain rejection or deprioritization logic State why the non-primary routes are weaker in this case. Use `references/rejection-reason-framework.md`. ### Step 9 — State dependencies and pivot conditions Identify what assumptions or resource changes could alter the recommendation. Use `references/dependency-and-pivot-rules.md`. ### Step 10 — Produce a downstream-ready recommendation Give a main-plan recommendation that can directly feed downstream study framing or protocol design. --- ## Mandatory Output Structure Always output the following sections. ### A. Core Question Interpretation Interpret the real question and clarify what the project is actually trying to resolve. ### B. Candidate Study Routes List the plausible route families and identify which are strong candidates versus weak surface options. ### C. Route-to-Question Fit Explain how each serious candidate route aligns or misaligns with the actual question. ### D. Early Route Elimination State which route options should be excluded early and why. ### E. Route Comparison Matrix Provide a structured comparison across the most important decision dimensions. Use a table when side-by-side comparison materially improves decision quality. ### F. Recommended Primary Plan Name the single recommended main route. ### G. Why This Route Should Lead Explain why this route is the best primary plan for this specific question. ### H. Why Other Routes Should Not Be Primary State why the main alternatives are weaker, premature, dependency-heavy, or better suited as secondary paths. ### I. Dependencies, Assumptions, and Pivot Triggers Explain what could change the recommendation. ### J. Downstream Routing State the best next step after primary-plan selection. --- ## Formatting Expectations Use short, clean sections. Use tables only when they materially improve comparison across candidate routes or decision dimensions. Do not force tables when concise explanatory prose is more precise. Keep the output decision-oriented: - what the real question is - what the serious route options are - which route should lead - why the other routes should not lead - what would change the recommendation --- ## Hard Rules 1. Always identify the real study question before recommending a primary route. 2. Never compare route options without first removing superficially plausible but structurally weak candidates. 3. Never treat complexity, novelty, or technical sophistication as a substitute for route fit. 4. Always distinguish the **primary plan** from secondary, embedded, or follow-up routes. 5. Never present all routes as equivalent when tradeoffs are real. 6. Always explain why the chosen route should lead. 7. Always explain why the rejected or deprioritized routes should not be the main plan. 8. Do not confuse validation steps with the correct primary route. 9. Do not recommend a mechanism-first route when the central need is still basic clinical association, unless the biological question truly leads. 10. Do not recommend a cohort-led route when the real uncertainty is still upstream mechanistic or discovery-stage. 11. When a hybrid staged plan is appropriate, clearly name which route leads and which route follows. 12. Never fabricate references, PMIDs, DOIs, prior evidence precedent, validation status, route maturity, feasibility claims, or study findings. 13. Never present vague field beliefs as literature-backed conclusions. 14. If route feasibility, precedent, or validation assumptions are uncertain, label them explicitly as limited, assumption-dependent, or unverified. 15. Treat the output as incomplete if it recommends a primary route without showing why the other routes are weaker. --- ## What This Skill Should Not Do This skill should not: - act like a full protocol generator - confuse brainstorming with route selection - recommend the most fashionable design by default - collapse all candidate routes into one vague hybrid without leadership logic - hide rejection reasons behind noncommittal language - invent evidence precedent to justify a preferred route --- ## Quality Standard A high-quality output should: - identify the real study question clearly - compare only serious candidate routes - show strong route-to-question matching logic - recommend one primary plan decisively - explain why alternatives are weaker in this case - name assumptions and pivot triggers honestly - remain downstream-ready for protocol framing - avoid fabricated literature or unsupported feasibility claims --- ## Associated Skills **Upstream** - `clinical-question-clarifier` - `study-objective-refiner` - `aim-and-hypothesis-designer` **Midstream** - `primary-plan-recommender` - `novelty-vs-feasibility-assessor` **Downstream** - `medical-research-gap-to-study-planner` - `method-gap-detector` - `medical-research-algorithm-matcher`
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.
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.
treatment-plans
Generate concise (typically 1–4 pages) patient-centered medical treatment plans in LaTeX/PDF when a clinician needs an actionable plan with SMART goals, evidence-based interventions, monitoring, and HIPAA-aware documentation.
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.
plan-generator
Automatically generates a Markdown final-exam review plan or lab experiment schedule when you provide a date range, tasks/items, and available daily hours (via interactive prompts or a one-time JSON input).
journal-recommender
Recommend academic journals based on manuscript topic, abstract, and impact factor expectations. Use when the user wants to find suitable journals for their research manuscript, especially when they provide a topic, abstract, and target Impact Factor.
poster-layout-planner
Use poster layout planner for other workflows that need structured execution, explicit assumptions, and clear output boundaries.
treatment-response-predictor-planner
Designs studies for predicting treatment response or resistance in biomedical and clinical research. Always use this skill when the user needs a treatment-response or resistance prediction study blueprint rather than a prognostic biomarker protocol, diagnostic test design, causal treatment-effect estimation, or a completed manuscript. Focus on responder definition, treatment context, baseline comparability, feature integration strategy, model development logic, validation architecture, and interpretation boundaries. Do not invent response rates, cohort size, assay readiness, regimen uniformity, literature support, or validation access.
sample-size-and-power-planning-assistant
Plans sample size estimation logic, power assumptions, feasibility checks, and fallback enrollment strategies for clinical and translational study protocols.