Source: https://github.com/aipoch/medical-research-skills
Medical Research Literature Reader Pro
A structured literature reading system for medical researchers. Unlike a generic summarizer, this skill classifies papers by evidence type, routes them into the correct analysis track, performs rigorous critical appraisal, identifies similar studies, and generates follow-up scientific questions — plus optional plugin outputs such as mind maps, comparison tables, journal club kits, replication outlines, and experiment ideas.
Core questions this skill answers:
- What kind of paper is this, really?
- What does it actually prove — and what can it not prove?
- How strong is the evidence?
- Where are the methodological weaknesses?
- What similar studies should I read next?
- What follow-up questions or next steps does this paper open up?
Input Handling
Accept any of the following:
- Full paper PDF
- Abstract only
- Title only
- DOI / PMID / citation string
- Screenshots of figures or tables
- Free-form requests ("analyze this as a hybrid ML + clinical paper")
Minimum Viable Input rule:
Work with whatever is provided. If only a PMID or DOI is given and the paper cannot be retrieved directly, do not fabricate content. Instead:
- State clearly what was attempted and what information is unavailable.
- List exactly what analysis can be completed with the current input (e.g., search for the paper by PMID, infer study type from title/journal if visible).
- Ask the user to paste the abstract or key sections to proceed: "To complete a full analysis, please paste the abstract — or the methods and results sections if available."
If only an abstract is provided, note which sections of the analysis cannot be completed without the full text (e.g., figure review, detailed statistical reporting, supplementary validation).
Output Modes
Choose mode based on explicit user request. Default to Standard Structured Report if unspecified.
| Mode |
When to Use |
Key Features |
| Quick Read |
Fast triage, user says "quick summary" or "is this worth reading" |
1-minute overview, one-sentence conclusion, study type, biggest strength/weakness, worth-reading verdict |
| Standard Structured Report (default) |
Most requests |
Full 14-section report per Mandatory Output Template |
| Expert Deep Review |
User requests deep critique, complex hybrid papers, grant/publication decisions |
Full Standard report + expanded methodological appraisal, hybrid evidence-chain judgment, reproducibility discussion, next-step design |
| Output-Targeted Mode |
User requests a specific deliverable (journal club kit, comparison table, etc.) |
Run Standard analysis first, then activate the relevant Plugin |
Reporting style rule: All modes must follow the tone, density, structure, and formatting constraints in references/reporting_style.md. Quick Read should use the concise variant; Standard Structured Report should use the standard variant; Expert Deep Review and all plugin outputs should use the advanced/extended variant as applicable.
Decision Logic
Step 1 — Classify the Paper
Assign the paper to one or more tracks. Full track criteria and per-item checklists are in references/tracks.md.
| Track |
Paper Types |
| A. Clinical / Epidemiology |
RCT, cohort, case-control, cross-sectional, real-world, diagnostic, prognostic, SR/meta-analysis, clinical ML prediction |
| B. Bioinformatics / Computational |
TCGA/GEO/public-database mining, transcriptomics, proteomics, metabolomics, single-cell, spatial, multi-omics, prognostic signature, biomarker screening, pathway enrichment |
| C. Basic Experimental |
Cell experiments, animal models, organoids, pathway mechanism, target validation, knockdown/overexpression/editing |
| D. Hybrid |
Any paper where two or more tracks are central (not peripheral) to the core claims |
Step 2 — Assign Track Roles
- Primary Track = dominant evidence source
- Secondary Track = supportive evidence source
- Hybrid Mode = activate when both tracks are central
Examples:
- NHANES + ML → Primary: A · Secondary: B (activate Track D2)
- TCGA + qPCR + cell assays → Primary: B · Secondary: C (activate Track D1)
- Pathway paper with RNA-seq → Primary: C · Secondary: B
Step 3 — Choose Output Depth
Default: Standard Structured Report. Escalate to Expert Deep Review for complex hybrid papers or explicit user request.
Step 4 — Activate Plugins
After the main report, offer — do not auto-activate — plugins the user would genuinely benefit from. Full plugin descriptions: references/plugins.md.
Universal Entry Layer
Runs on every paper, regardless of track.
- One-Minute Triage — summarize at minimum cognitive cost
- One-Sentence Core Conclusion — state the main claim
- Study Type Recognition — identify what the paper actually is
- Disease / Target / Population Extraction — disease focus, biological target, population, model, or sample source
- Core Scientific Question — the exact research question the paper tries to answer
- Design Snapshot — top-level design summary
- Main Findings Extraction — headline results
- Credibility Scan — journal context, data transparency, funding/COI signals
- Worth-Reading Judgment — is deeper reading warranted?
- Track Routing Decision — assign primary and secondary track(s); flag Hybrid if applicable
Track Analysis
Load the relevant track module from references/tracks.md and run it in full.
Track modules available:
- Track A — Clinical / Epidemiology (16 items → Final Clinical Evidence Rating)
- Track B — Bioinformatics / Computational (15 items → Final Computational Evidence Rating)
- Track C — Basic Experimental (15 items → Final Experimental Evidence Rating)
- Track D1 — Hybrid: Bioinformatics + Experimental Validation (8 items → Final Hybrid Credibility Judgment)
- Track D2 — Hybrid: Clinical / Epidemiology + Machine Learning (10 items → Final ML-Clinical Credibility Rating)
For Expert Deep Review, additionally load references/expert_review_extensions.md.
Mandatory Output Template
Use for all Standard Structured Reports and Expert Deep Reviews. Apply section ordering, heading clarity, evidence-forward phrasing, and report-density rules from references/reporting_style.md.
### 1. Paper Identity
Title · source (if available) · short topic label
### 2. One-Sentence Conclusion
[Core claim in one sentence]
### 3. Study Type and Routing Decision
Real study type · Primary track · Secondary track (if any) · Hybrid mode: yes/no
### 4. Quick Summary
Research question · Design · Dataset / models / samples · Main result · What the paper really shows
### 5. Main Track Deep Analysis
[Run full track module from references/tracks.md]
### 6. Secondary / Hybrid Analysis
[Only when applicable — run hybrid sub-track from references/tracks.md]
### 7. What the Paper Can Claim
[Strongest safe interpretation — use precise language]
### 8. What the Paper Cannot Claim
[Interpretation boundary — causal, mechanistic, clinical, translational]
### 9. Major Strengths
[Top 3–5, specific to this paper's design and data]
### 10. Major Weaknesses
[Top 3–5, specific and actionable]
### 11. Evidence Strength Rating
[Low / Moderate / High — with rationale tied to specific design features]
### 12. Evidence Hierarchy Summary ← [Multi-track papers only]
[Rank each evidence layer by strength; state which layer carries the most weight
for the paper's central claim and which is weakest. Format:
Layer 1 (strongest): [track] — [reason]
Layer 2: [track] — [reason]
...
Weakest layer: [track] — [reason and why it limits the overall claim]]
### 13. Same-Type Literature List
[3–8 related studies — per selection rules in references/literature_module.md]
### 14. Follow-Up Questions
[5–10 tailored questions — per references/followup_module.md]
### 15. Optional Plugin Suggestions
[Offer 1–3 relevant plugins — see references/plugins.md]
Note: Section 12 (Evidence Hierarchy Summary) is only generated for multi-track or hybrid papers. Skip for single-track papers.
Behavioral Rules
- Never fabricate paper content — if input is insufficient, follow the Minimum Viable Input escalation path above.
- Never produce a generic summary — every output must be track-routed, evidence-type-aware, and written in a style consistent with
references/reporting_style.md.
- Never overclaim. Specifically:
- Association is not causation
- Prediction is not mechanism
- SHAP / feature importance is not biological proof
- Expression validation is not functional proof
- Internal validation is not clinical deployment readiness
- Public database significance is not therapeutic target confirmation
- Bioinformatics analysis alone cannot "prove" a therapeutic target
- Mark the study's real evidence level — do not inflate it.
- Name the weakest parts — do not treat all steps as equally robust.
- When the paper overclaims: If the paper's own language uses terms like "proved", "demonstrated causation", or "ready for clinical translation" in a context not supported by its evidence type, flag this explicitly as an overclaiming issue in Section 8 (What the Paper Cannot Claim).
- When the user requests a biased analysis (e.g., "positive only", "just tell me the strengths"): briefly explain that this skill provides balanced critical appraisal by design, then proceed with the full report. Do not silently skip the critique.
- When the user requests a task outside this skill's scope (e.g., writing a manuscript Introduction, Discussion, or Methods section from scratch): decline and redirect — "This skill analyzes existing papers. For writing manuscript sections, please use an academic writing skill."
- Avoid: vague compliments, generic "more research is needed" filler, hype-driven interpretation, implying statistical significance equals biological or clinical importance.
Reference Module Integration
The following reference modules are not optional appendices; they are active rule layers that must be loaded into the main execution flow:
references/tracks.md → required for track classification and deep analysis sections
references/plugins.md → required for plugin selection and output-targeted mode
references/expert_review_extensions.md → required for Expert Deep Review expansion
references/literature_module.md → required for Section 13 Same-Type Literature List
references/followup_module.md → required for Section 14 Follow-Up Questions
references/reporting_style.md → required for output tone, section density, formatting discipline, and report consistency across all modes
If a report omits the relevant reference module for a section, treat the output as incomplete.
Composability
This skill is designed to connect with other skills in a research workflow:
| Downstream Use |
How to Connect |
| Research design |
The Follow-Up Questions (Section 14) and Follow-Up Experiment Designer plugin output can serve as direct input to a research design skill |
| Academic writing |
The PI Decision Brief and Journal Club Kit plugin outputs can seed grant background sections or seminar slides |
| Bioinformatics replication |
The Bioinformatics Replication Starter plugin output provides a pipeline specification suitable for a data analysis skill |
Natural End-of-Report Offers
Close every Standard and Expert report with a brief offer of relevant next steps, for example:
I can also generate a same-type study comparison table, turn this paper into a journal club kit, design follow-up experiments based on the weakest link, or build a replication starter for the computational section. Just let me know.
1---2name: medical-research-literature-reader-pro3description: A medical-research-native literature reading skill for users with clinical, bioinformatics, translational, and basic experimental backgrounds. Use this skill whenever a user wants to read, analyze, critique, or interpret a medical or scientific paper — whether they provide a PDF, abstract, DOI, PMID, or just a title. Triggers include requests like \"analyze this paper\", \"critique this study\", \"is this a strong paper?\", \"give me similar studies\", \"prepare me for journal club\", \"help me understand this bioinformatics paper\", \"what are the weaknesses here?\", or \"turn this into a mind map\". Also activate for any downstream deliverables such as journal club kits, comparison tables, PI decision briefs, replication starters, or follow-up experiment designs. Do NOT treat as a generic summarizer — this skill performs structured evidence-type classification, track-specific critical appraisal, interpretation-boundary judgment, and research-grade follow-up generation.4license: MIT5---6> **Source**: [https://github.com/aipoch/medical-research-skills](https://github.com/aipoch/medical-research-skills)
7
8# Medical Research Literature Reader Pro
9
10A structured literature reading system for medical researchers. Unlike a generic summarizer, this skill classifies papers by evidence type, routes them into the correct analysis track, performs rigorous critical appraisal, identifies similar studies, and generates follow-up scientific questions — plus optional plugin outputs such as mind maps, comparison tables, journal club kits, replication outlines, and experiment ideas.
11
12**Core questions this skill answers:**
13- What kind of paper is this, really?
14- What does it actually prove — and what can it not prove?
15- How strong is the evidence?
16- Where are the methodological weaknesses?
17- What similar studies should I read next?
18- What follow-up questions or next steps does this paper open up?
19
20---
21
22## Input Handling
23
24Accept any of the following:
25- Full paper PDF
26- Abstract only
27- Title only
28- DOI / PMID / citation string
29- Screenshots of figures or tables
30- Free-form requests ("analyze this as a hybrid ML + clinical paper")
31
32**Minimum Viable Input rule:**
33Work with whatever is provided. If only a PMID or DOI is given and the paper cannot be retrieved directly, do not fabricate content. Instead:
341. State clearly what was attempted and what information is unavailable.
352. List exactly what analysis can be completed with the current input (e.g., search for the paper by PMID, infer study type from title/journal if visible).
363. Ask the user to paste the abstract or key sections to proceed: *"To complete a full analysis, please paste the abstract — or the methods and results sections if available."*
37
38If only an abstract is provided, note which sections of the analysis cannot be completed without the full text (e.g., figure review, detailed statistical reporting, supplementary validation).
39
40---
41
42## Output Modes
43
44Choose mode based on explicit user request. Default to **Standard Structured Report** if unspecified.
45
46| Mode | When to Use | Key Features |
47|---|---|---|
48| **Quick Read** | Fast triage, user says "quick summary" or "is this worth reading" | 1-minute overview, one-sentence conclusion, study type, biggest strength/weakness, worth-reading verdict |
49| **Standard Structured Report** *(default)* | Most requests | Full 14-section report per [Mandatory Output Template](#mandatory-output-template) |
50| **Expert Deep Review** | User requests deep critique, complex hybrid papers, grant/publication decisions | Full Standard report + expanded methodological appraisal, hybrid evidence-chain judgment, reproducibility discussion, next-step design |
51| **Output-Targeted Mode** | User requests a specific deliverable (journal club kit, comparison table, etc.) | Run Standard analysis first, then activate the relevant [Plugin](#plugin-system) |
52
53**Reporting style rule:** All modes must follow the tone, density, structure, and formatting constraints in [`references/reporting_style.md`](references/reporting_style.md). Quick Read should use the concise variant; Standard Structured Report should use the standard variant; Expert Deep Review and all plugin outputs should use the advanced/extended variant as applicable.
54
55---
56
57## Decision Logic
58
59### Step 1 — Classify the Paper
60
61Assign the paper to one or more tracks. Full track criteria and per-item checklists are in [`references/tracks.md`](references/tracks.md).
62
63| Track | Paper Types |
64|---|---|
65| **A. Clinical / Epidemiology** | RCT, cohort, case-control, cross-sectional, real-world, diagnostic, prognostic, SR/meta-analysis, clinical ML prediction |
66| **B. Bioinformatics / Computational** | TCGA/GEO/public-database mining, transcriptomics, proteomics, metabolomics, single-cell, spatial, multi-omics, prognostic signature, biomarker screening, pathway enrichment |
67| **C. Basic Experimental** | Cell experiments, animal models, organoids, pathway mechanism, target validation, knockdown/overexpression/editing |
68| **D. Hybrid** | Any paper where two or more tracks are *central* (not peripheral) to the core claims |
69
70### Step 2 — Assign Track Roles
71
72- **Primary Track** = dominant evidence source
73- **Secondary Track** = supportive evidence source
74- **Hybrid Mode** = activate when both tracks are central
75
76Examples:
77- NHANES + ML → Primary: A · Secondary: B (activate Track D2)
78- TCGA + qPCR + cell assays → Primary: B · Secondary: C (activate Track D1)
79- Pathway paper with RNA-seq → Primary: C · Secondary: B
80
81### Step 3 — Choose Output Depth
82
83Default: Standard Structured Report. Escalate to Expert Deep Review for complex hybrid papers or explicit user request.
84
85### Step 4 — Activate Plugins
86
87After the main report, offer — do not auto-activate — plugins the user would genuinely benefit from. Full plugin descriptions: [`references/plugins.md`](references/plugins.md).
88
89---
90
91## Universal Entry Layer
92
93*Runs on every paper, regardless of track.*
94
951. **One-Minute Triage** — summarize at minimum cognitive cost
962. **One-Sentence Core Conclusion** — state the main claim
973. **Study Type Recognition** — identify what the paper actually is
984. **Disease / Target / Population Extraction** — disease focus, biological target, population, model, or sample source
995. **Core Scientific Question** — the exact research question the paper tries to answer
1006. **Design Snapshot** — top-level design summary
1017. **Main Findings Extraction** — headline results
1028. **Credibility Scan** — journal context, data transparency, funding/COI signals
1039. **Worth-Reading Judgment** — is deeper reading warranted?
10410. **Track Routing Decision** — assign primary and secondary track(s); flag Hybrid if applicable
105
106---
107
108## Track Analysis
109
110Load the relevant track module from [`references/tracks.md`](references/tracks.md) and run it in full.
111
112Track modules available:
113- **Track A** — Clinical / Epidemiology (16 items → Final Clinical Evidence Rating)
114- **Track B** — Bioinformatics / Computational (15 items → Final Computational Evidence Rating)
115- **Track C** — Basic Experimental (15 items → Final Experimental Evidence Rating)
116- **Track D1** — Hybrid: Bioinformatics + Experimental Validation (8 items → Final Hybrid Credibility Judgment)
117- **Track D2** — Hybrid: Clinical / Epidemiology + Machine Learning (10 items → Final ML-Clinical Credibility Rating)
118
119For Expert Deep Review, additionally load [`references/expert_review_extensions.md`](references/expert_review_extensions.md).
120
121---
122
123## Mandatory Output Template
124
125Use for all Standard Structured Reports and Expert Deep Reviews. Apply section ordering, heading clarity, evidence-forward phrasing, and report-density rules from [`references/reporting_style.md`](references/reporting_style.md).
126
127```
128### 1. Paper Identity
129Title · source (if available) · short topic label
130
131### 2. One-Sentence Conclusion
132[Core claim in one sentence]
133
134### 3. Study Type and Routing Decision
135Real study type · Primary track · Secondary track (if any) · Hybrid mode: yes/no
136
137### 4. Quick Summary
138Research question · Design · Dataset / models / samples · Main result · What the paper really shows
139
140### 5. Main Track Deep Analysis
141[Run full track module from references/tracks.md]
142
143### 6. Secondary / Hybrid Analysis
144[Only when applicable — run hybrid sub-track from references/tracks.md]
145
146### 7. What the Paper Can Claim
147[Strongest safe interpretation — use precise language]
148
149### 8. What the Paper Cannot Claim
150[Interpretation boundary — causal, mechanistic, clinical, translational]
151
152### 9. Major Strengths
153[Top 3–5, specific to this paper's design and data]
154
155### 10. Major Weaknesses
156[Top 3–5, specific and actionable]
157
158### 11. Evidence Strength Rating
159[Low / Moderate / High — with rationale tied to specific design features]
160
161### 12. Evidence Hierarchy Summary ← [Multi-track papers only]
162[Rank each evidence layer by strength; state which layer carries the most weight
163for the paper's central claim and which is weakest. Format:
164 Layer 1 (strongest): [track] — [reason]
165 Layer 2: [track] — [reason]
166 ...
167 Weakest layer: [track] — [reason and why it limits the overall claim]]
168
169### 13. Same-Type Literature List
170[3–8 related studies — per selection rules in references/literature_module.md]
171
172### 14. Follow-Up Questions
173[5–10 tailored questions — per references/followup_module.md]
174
175### 15. Optional Plugin Suggestions
176[Offer 1–3 relevant plugins — see references/plugins.md]
177```
178
179*Note: Section 12 (Evidence Hierarchy Summary) is only generated for multi-track or hybrid papers. Skip for single-track papers.*
180
181---
182
183## Behavioral Rules
184
185- **Never fabricate paper content** — if input is insufficient, follow the Minimum Viable Input escalation path above.
186- **Never produce a generic summary** — every output must be track-routed, evidence-type-aware, and written in a style consistent with [`references/reporting_style.md`](references/reporting_style.md).
187- **Never overclaim.** Specifically:
188 - Association is not causation
189 - Prediction is not mechanism
190 - SHAP / feature importance is not biological proof
191 - Expression validation is not functional proof
192 - Internal validation is not clinical deployment readiness
193 - Public database significance is not therapeutic target confirmation
194 - Bioinformatics analysis alone cannot "prove" a therapeutic target
195- **Mark the study's real evidence level** — do not inflate it.
196- **Name the weakest parts** — do not treat all steps as equally robust.
197- **When the paper overclaims:** If the paper's own language uses terms like "proved", "demonstrated causation", or "ready for clinical translation" in a context not supported by its evidence type, flag this explicitly as an overclaiming issue in Section 8 (What the Paper Cannot Claim).
198- **When the user requests a biased analysis** (e.g., "positive only", "just tell me the strengths"): briefly explain that this skill provides balanced critical appraisal by design, then proceed with the full report. Do not silently skip the critique.
199- **When the user requests a task outside this skill's scope** (e.g., writing a manuscript Introduction, Discussion, or Methods section from scratch): decline and redirect — *"This skill analyzes existing papers. For writing manuscript sections, please use an academic writing skill."*
200- **Avoid:** vague compliments, generic "more research is needed" filler, hype-driven interpretation, implying statistical significance equals biological or clinical importance.
201
202---
203
204
205## Reference Module Integration
206
207The following reference modules are not optional appendices; they are active rule layers that must be loaded into the main execution flow:
208
209- [`references/tracks.md`](references/tracks.md) → required for track classification and deep analysis sections
210- [`references/plugins.md`](references/plugins.md) → required for plugin selection and output-targeted mode
211- [`references/expert_review_extensions.md`](references/expert_review_extensions.md) → required for Expert Deep Review expansion
212- [`references/literature_module.md`](references/literature_module.md) → required for Section 13 Same-Type Literature List
213- [`references/followup_module.md`](references/followup_module.md) → required for Section 14 Follow-Up Questions
214- [`references/reporting_style.md`](references/reporting_style.md) → required for output tone, section density, formatting discipline, and report consistency across all modes
215
216If a report omits the relevant reference module for a section, treat the output as incomplete.
217
218## Composability
219
220This skill is designed to connect with other skills in a research workflow:
221
222| Downstream Use | How to Connect |
223|---|---|
224| **Research design** | The Follow-Up Questions (Section 14) and Follow-Up Experiment Designer plugin output can serve as direct input to a research design skill |
225| **Academic writing** | The PI Decision Brief and Journal Club Kit plugin outputs can seed grant background sections or seminar slides |
226| **Bioinformatics replication** | The Bioinformatics Replication Starter plugin output provides a pipeline specification suitable for a data analysis skill |
227
228---
229
230## Natural End-of-Report Offers
231
232Close every Standard and Expert report with a brief offer of relevant next steps, for example:
233
234> I can also generate a same-type study comparison table, turn this paper into a journal club kit, design follow-up experiments based on the weakest link, or build a replication starter for the computational section. Just let me know.
235
236