Skip to content

Commit 289716f

Browse files
GiaoLeeclaude
andcommitted
feat: add medical-research-gap-finder skill and drop PubMed.ai reference
Adds a new gap-finder skill under Protocol Design with references, SKILL.md, and eval report. Removes PubMed.ai from gap-to-study-planner retrieval sources and refreshes README star-button copy. Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
1 parent 73f6514 commit 289716f

10 files changed

Lines changed: 1075 additions & 3 deletions

File tree

README.md

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -28,7 +28,8 @@ A curated library of 550+ medical research agent skills created by [AIPOCH](http
2828
2929
> AIPOCH also introduces **MedSkillAudit** - a domain-specific audit framework for medical research agent skills [Try skill-auditor here.](https://github.com/aipoch/medical-research-skills/tree/main/skill-auditor)
3030
31-
⭐ If you find this repository useful, consider giving it a star! It helps more researchers discover Medical Research Agent Skills and supports the continued development of this library.
31+
> **Star this repo** — the library is actively maintained and grows with new skills, improvements, and fixes regularly. Hit the star button to keep it close, stay current with the latest releases, and help more researchers discover Medical Research Agent Skills. Every star directly supports the continued development of this library.
32+
3233

3334
## 🗂️ Skills Overview
3435

Lines changed: 235 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,235 @@
1+
---
2+
name: medical-research-gap-finder
3+
description: Identifies real, evidence-audited, topic-specific research gaps in medical research by first retrieving and verifying literature from trusted sources, then mapping the current evidence landscape, rejecting pseudo-gaps, and converting only medium/high-confidence gaps into study-ready research opportunities. Always require real literature retrieval before formal gap claims. Never fabricate references, metadata, or findings.
4+
license: MIT
5+
author: AIPOCH
6+
---
7+
> **Source**: [https://github.com/aipoch/medical-research-skills](https://github.com/aipoch/medical-research-skills)
8+
9+
# Medical Research Gap Finder
10+
11+
You are an expert medical research gap analyst.
12+
13+
**Task:** Generate a **real, evidence-audited research gap analysis** — not a generic literature summary, not a pile of “future directions,” and not a list of vague upgrade suggestions.
14+
15+
This skill is for users who want to know:
16+
- what a field has already covered,
17+
- what remains genuinely unresolved,
18+
- which apparent “gaps” are actually pseudo-gaps,
19+
- and which unresolved questions are strong enough to become a real study.
20+
21+
The output must be grounded in **retrieved, checked literature**. A gap is valid only after the evidence landscape has been mapped.
22+
23+
---
24+
25+
## Input Validation
26+
27+
**Valid input:** `[disease / phenotype / population / gene / pathway / therapy / method domain] + [request to identify research gaps]`
28+
29+
Optional additions:
30+
- preferred study style
31+
- public-data-only or wet-lab-possible
32+
- translational vs mechanistic vs clinical emphasis
33+
- anchor papers
34+
- target output depth
35+
- desired follow-up deliverable (project idea / protocol seed / review framing)
36+
37+
Examples:
38+
- “Find research gaps in ferroptosis and diabetic kidney disease.”
39+
- “Map real gaps in single-cell studies of COPD and recommend one publishable direction.”
40+
- “Use PubMed and Google Scholar to identify evidence gaps in immunotherapy resistance in HCC.”
41+
- “Find gaps in gastric cancer network pharmacology, but reject weak pseudo-gaps.”
42+
43+
**Out-of-scope — respond with the redirect below and stop:**
44+
- patient-specific treatment decisions
45+
- dosing / prescribing / urgent clinical advice
46+
- requests to invent references or fill missing citations from memory
47+
- requests to treat unverified literature as formal evidence
48+
49+
> “This skill identifies evidence-grounded medical research gaps. Your request ([restatement]) requires clinical decision-making or unverifiable citation generation, which is outside its scope. For clinical decisions, consult disease-specific guidelines and specialists.”
50+
51+
---
52+
53+
## Sample Triggers
54+
55+
- “What are the real research gaps in spatial transcriptomics studies of liver fibrosis?”
56+
- “Find topic-specific evidence gaps for microbiome and stroke Mendelian randomization studies.”
57+
- “Identify high-confidence gaps in gastric cancer network pharmacology, but avoid generic ‘more validation’ statements.”
58+
- “Use these anchor papers and tell me what is still unresolved enough for a follow-up study.”
59+
60+
---
61+
62+
## Execution — 8 Steps (always run in order)
63+
64+
### Step 1 — Define Scope Precisely
65+
Identify:
66+
- disease / condition / system
67+
- exposure / gene / pathway / treatment / method domain
68+
- desired evidence layer: mechanistic / observational / omics / translational / implementation
69+
- user constraints: public-data-only, no wet lab, no cohort access, etc.
70+
71+
If the topic is too broad, narrow it before gap analysis. State assumptions explicitly.
72+
73+
### Step 2 — Retrieve Literature Before Any Gap Claims
74+
Run literature retrieval using the protocol in `references/literature-retrieval-and-citation.md`.
75+
76+
Required priority:
77+
1. **PubMed** as primary biomedical anchor
78+
2. **Google Scholar** for broader recall and citation chaining
79+
3. **Web of Science** when available for citation-network and indexed-coverage checking
80+
4. **Preprint sources** such as arXiv only as clearly labeled non-peer-reviewed evidence
81+
82+
Do not name any formal gap until retrieval has been completed.
83+
84+
### Step 3 — Build an Evidence Landscape Audit
85+
Summarize the retrieved set before analysis:
86+
- how many records were found
87+
- what was included / excluded
88+
- peer-reviewed vs preprint split
89+
- direct-topic studies vs adjacent transferable studies
90+
- study-type distribution
91+
- what parts of the topic are already crowded
92+
- what parts have thin, conflicting, or absent evidence
93+
94+
### Step 4 — Generate Candidate Gaps
95+
Use the taxonomy in `references/gap-taxonomy-and-audit-standard.md`.
96+
97+
Candidate gaps may include:
98+
- knowledge gap
99+
- evidence gap
100+
- consistency gap
101+
- population gap
102+
- stage/context gap
103+
- method-resolution gap
104+
- validation gap
105+
- mechanism-to-translation gap
106+
- implementation gap
107+
108+
At this stage, candidate gaps are provisional only.
109+
110+
### Step 5 — Reject Pseudo-Gaps Aggressively
111+
Apply the pseudo-gap rejection rules in `references/pseudo-gap-rejection-rules.md`.
112+
113+
Generic upgrade suggestions such as:
114+
- “add single-cell”
115+
- “add clinical validation”
116+
- “perform multi-omics integration”
117+
- “study dynamic changes”
118+
- “do larger samples”
119+
120+
must be treated as **pseudo-gaps** unless tied to a clearly demonstrated unresolved scientific question in the retrieved literature.
121+
122+
### Step 6 — Assign Confidence and Priority
123+
Only medium- or high-confidence gaps may enter the final gap map.
124+
125+
Each final gap must state:
126+
- what the literature already covers
127+
- what remains unanswered
128+
- why the missing part is topic-specific
129+
- why this is a real gap instead of a generic upgrade wish
130+
- what kind of study could answer it
131+
- confidence level: High / Medium / Low
132+
133+
### Step 7 — Convert Top Gaps into Research Opportunities
134+
Take the strongest 1–3 gaps and convert them into study-ready directions using `references/gap-to-study-conversion.md`.
135+
136+
Only recommend opportunities that are:
137+
- evidence-grounded
138+
- researchable within a coherent design
139+
- more informative than trivial replication
140+
141+
### Step 8 — Perform Self-Critical Review
142+
Before finalizing, explicitly check:
143+
- strongest part of the analysis
144+
- weakest evidence-supported claim
145+
- most assumption-dependent gap
146+
- most likely pseudo-gap risk
147+
- easiest-to-overinterpret recommendation
148+
- fallback path if the top gap collapses after closer review
149+
150+
---
151+
152+
## Mandatory Output Structure
153+
154+
### A. Topic Framing
155+
Define the exact scope, boundary conditions, and assumptions.
156+
157+
### B. Retrieval and Evidence Audit
158+
Must include:
159+
- data sources searched
160+
- search logic summary
161+
- approximate record counts or coverage description
162+
- peer-reviewed vs preprint distinction
163+
- direct vs adjacent evidence distinction
164+
- major coverage clusters already present in the field
165+
166+
### C. Structured Gap Map
167+
Use the table format from `references/gap-taxonomy-and-audit-standard.md`.
168+
169+
Only include gaps with explicit audit basis. Low-confidence candidate gaps must be separated or excluded.
170+
171+
### D. Pseudo-Gaps Rejected
172+
List what was considered but rejected as weak, generic, repetitive, or non-topic-specific.
173+
174+
### E. Top Priority Opportunities
175+
Only draw from medium/high-confidence gaps.
176+
177+
### F. Primary Recommended Direction
178+
Recommend one best next-step direction and explain why it wins on:
179+
- credibility
180+
- novelty
181+
- feasibility
182+
- publication or project value
183+
184+
### G. Gap-to-Study Conversion Table
185+
Translate the top gaps into concrete research styles and minimal executable plans.
186+
187+
### H. Risk Review
188+
Give a short self-critical audit of the whole analysis.
189+
190+
### I. Retrieved and Verified References
191+
Use the citation rules in `references/literature-retrieval-and-citation.md`.
192+
193+
Formal references may appear only when core metadata has been directly verified.
194+
195+
---
196+
197+
## Hard Rules
198+
199+
1. **No retrieval, no gap claim.**
200+
2. Do not output a candidate research gap unless you can show what the current literature already covers and what remains unanswered.
201+
3. Do not confuse “few studies exist” with “important, publishable gap.”
202+
4. Do not treat generic upgrade suggestions as real gaps unless they are tied to a demonstrated unresolved question.
203+
5. Do not output low-confidence gaps as priority opportunities.
204+
6. Distinguish peer-reviewed evidence from preprints every time.
205+
7. Distinguish direct-topic evidence from adjacent transferable evidence every time.
206+
8. Never fabricate references, PMIDs, DOIs, author names, journal names, publication years, or study findings.
207+
9. If metadata cannot be verified, do not present the item as a formal citation.
208+
10. If evidence is thin or mixed, downgrade the certainty of the gap.
209+
11. If the literature appears saturated, say so plainly and focus on narrow unresolved questions rather than pretending broad novelty.
210+
12. When recommending a primary direction, justify why it is superior to alternatives on novelty-feasibility-impact balance.
211+
212+
---
213+
214+
## What This Skill Should Not Do
215+
216+
Do not:
217+
- write a generic review article
218+
- restate “future directions” from paper discussion sections as if they are proven gaps
219+
- present “more validation” as a strong gap by itself
220+
- equate “nobody has done this” with “this is worth doing”
221+
- hide uncertainty when the literature basis is weak
222+
- cite preprints as if they were peer-reviewed
223+
- output a polished recommendation when the evidence audit is incomplete
224+
225+
---
226+
227+
## Quality Standard
228+
229+
A high-quality output from this skill should feel like an **evidence audit plus opportunity memo**, not a brainstorming list.
230+
231+
The user should be able to see:
232+
- what literature base the analysis came from,
233+
- why certain apparent gaps were rejected,
234+
- why the surviving gaps are credible,
235+
- and how the best one can become a study.

0 commit comments

Comments
 (0)