medical-research
Retrieves scientific papers from PubMed and creates plain-language research summaries. Use when users ask about medical research, scientific studies, clinical trials, disease treatments, or want to understand recent scientific literature on any biomedical topic.
By gexijin · 641 installs
npx skills add gexijin/vibe --skill medical-research
Source repository · Upstream listing
Medical Research
Purpose
This Skill retrieves scientific papers from PubMed and creates accessible, plain language summaries of current research on any biomedical or life sciences topic. It bridges the gap between complex scientific literature and general understanding.
When to Use This Skill
Automatically activate when users:
Ask about scientific research on medical topics (e.g., "What's the latest on Alzheimer's treatment?")
Want to understand current studies on diseases or conditions
Request information about clinical trials or treatment approaches
Mention specific research areas (immunotherapy, gene therapy, drug development)
Ask questions like "summarize research on..." or "what does research say about..."
Need to understand scientific consensus on health topics
Instructions
When generating a research summary, follow these steps:
1. Identify the Research Query
Accept natural language queries (e.g., "immunotherapy for breast cancer")
Clarify if the topic is too broad (e.g., "cancer" → suggest narrowing to specific type)
Verify spelling of medical terms
If ambiguous, ask for clarification before proceeding
2. Retrieve Scientific Papers
Use the skill's built in pubmed search.py script located in .claude/skills/medical research/ :
Default retrieves 10 most recent papers
For comprehensive summaries, consider increasing max results in the script
Capture paper details: titles, authors, abstracts, PMIDs, publication dates
3. Analyze and Synthesize Findings
Review the retrieved papers and identify:
1. Main Research Themes
What are the major topics being studied?
What questions are researchers trying to answer?
What approaches or methods are common?
2. Key Findings
What are the main discoveries or results?
What treatments or interventions show promise?
What mechanisms are being investigated?
3. Clinical Implications
How might this research affect patient care?
What are practical applications?
What changes to treatment guidelines might result?
4. Challenges and Limitations
What problems remain unsolved?
What resistance mechanisms exist?
What gaps in knowledge persist?
5. Emerging Directions
What new approaches are being developed?
What future research is needed?
What technologies are being applied?
4. Write Plain Language Summary
Structure the summary for general audience understanding:
5. Save the Summary
Automatically save as markdown file
Use filename format: Research Summary {Topic} {YYYY MM DD}.md
Replace spaces in topic with underscores
Place in current working directory
Confirm file location to user
Quality Guidelines
Content Standards
Accessibility : Write at a 10th grade reading level
Accuracy : Faithfully represent research findings; don't oversimplify to the point of distortion
Balance : Include both promising developments and challenges
Currency : Focus on papers from the last 1 2 years when possible
Context : Explain why research matters and how it fits into bigger picture
Clarity : Define medical/scientific terms; use analogies when helpful
Language Guidelines
Do:
Use active voice ("Researchers found..." not "It was found...")
Define abbreviations on first use (e.g., "TNBC (triple negative breast cancer)")
Use concrete examples
Explain mechanisms in simple terms
Provide context for numbers and statistics
Use analogies to explain complex concepts
Don't:
Use jargon without explanation
Oversimplify to the point of inaccuracy
Make claims stronger than the research supports
Provide medical advice
Use passive voice excessively
Assume prior knowledge of biology/medicine
Credibility Standards
Objectivity : Present findings without bias
Accuracy : Cite specific PMIDs and paper details
Transparency : Note when information is limited or preliminary
Disclaimers : Always include educational/non medical advice disclaimer
Dates : Include publication years to show currency
Examples
Example 1: Treatment Research
User request : Summarize research on immunotherapy for melanoma
Expected behavior :
1. Run: python3 .claude/skills/medical research/pubmed search.py "immunotherapy melanoma"
2. Analyze ~10 recent papers
3. Identify themes: resistance mechanisms, combination therapies, biomarkers
4. Write plain language summary explaining immune checkpoint inhibitors, how they work, current challenges
5. Save as Research Summary Immunotherapy Melanoma 2025 12 13.md
Example 2: Disease Mechanism
User request : What does research say about Alzheimer's disease causes?
Expected behavior :
1. Activate Skill automatically
2. Run: python3 .claude/skills/medical research/pubmed search.py "Alzheimer's disease pathogenesis"
3. Synthesize findings on amyloid, tau, inflammation, genetic factors
4. Explain competing theories in accessible language
5. Highlight controversies and ongoing debates
6. Save comprehensive summary
Example 3: Emerging Technology
User request : Tell me about CRISPR gene therapy research
Expected behavior :
1. Run: python3 .claude/skills/medical research/pubmed search.py "CRISPR gene therapy clinical trials"
2. Focus on clinical applications, safety, efficacy
3. Explain CRISPR technology simply (e.g., "molecular scissors that can edit DNA")
4. Include specific examples of diseases being treated
5. Address ethical considerations if prominent in literature
6. Save summary with examples
Best Practices
Do's
✓ Start with broad overview before diving into details
✓ Use subheadings to break up long sections
✓ Include "Key Terminology" section for important terms
✓ Provide specific examples from papers
✓ Explain statistical significance in plain language
✓ Note when findings are preliminary or need replication
✓ Connect research to real world impact
Don'ts
✗ Don't recommend specific treatments or medications
✗ Don't use unexplained acronyms (EGFR, VEGF, etc.)
✗ Don't ignore negative findings or failures
✗ Don't exaggerate promises ("cure for cancer")
✗ Don't skip the educational disclaimer
✗ Don't assume readers have science background
✗ Don't make summary too technical
Handling Edge Cases
Few or No Papers Found
If PubMed returns few results:
Highly Technical Results
If papers are extremely technical:
Controversial Topics
For topics with conflicting research:
Outdated Research
If most papers are older than 2 years:
Technical Requirements
Tools to Use
Bash : Run the pubmed search.py script
Read : Optionally read papers or abstracts if more detail needed
Write : Save the completed summary to markdown file
WebFetch (optional): Retrieve full papers from PubMed if abstracts insufficient
Search Strategy
1. Start specific : Use precise medical terms
2. Iterate if needed : Broaden or narrow based on results
3. Check paper count : Aim for 10 20 papers for comprehensive summary
4. Verify relevance : Ensure retrieved papers match the query
5. Note search date : Document when search was performed
Script Modifications
If needed, users can modify pubmed search.py :
Increase max results for more comprehensive reviews
Update Entrez.email with their email address
Adjust abstract length display
File Output Specifications
Default Format: Markdown
Content Requirements
Minimum 800 words for comprehensive topics
At least 3 major themes identified
3 5 key terms defined
3 5 papers highlighted
Include all template sections
Quality Checklist
Before saving, verify:
[ ] Summary is accessible to non scientists
[ ] Medical terms are defined
[ ] Key findings are accurate to source papers
[ ] Clinical implications explained
[ ] Challenges and limitations included
[ ] Recent papers cited with PMIDs
[ ] Educational disclaimer included
[ ] Filename follows format
[ ] All sections complete
[ ] Free of unexplained jargon
Related Resources
PubMed : https://pubmed.ncbi.nlm.nih.gov/
Biopython Entrez Documentation : For script customization
MeSH Terms : Medical Subject Headings for refined searches
NIH Plain Language : For accessibility guidelines
Version : 1.0
Last Updated : December 2025
Maintained By : Vibe Project