pubmed-database
Skill80 starsChanged 8 months agoMITView on GitHub
Direct REST API access to PubMed. Advanced Boolean/MeSH queries, E-utilities API, batch processing, citation management. For Python workflows, prefer biopython (Bio.Entrez). Use this for direct HTTP/REST work or custom API implementations.
- Reads credentials
19 other projects use a version of this, 8 of them edited.
Adopted by
Most recently taken up by
- Ivan-propio/claude-skillsedited, first seen Nov 16, 2026
- 1stANUNNAKI/The-Counciltheir own version, first seen Nov 16, 2026
- google-deepmind/science-skillstheir own version, first seen Nov 10, 2026
- BrightGold70/skillsedited, first seen Nov 8, 2026
- 1stANUNNAKI/majlistheir own version, first seen Nov 8, 2026
- MarieLynneBlock/arcanum-artifexedited, first seen Nov 1, 2026
Other versions19 projects use a version of this.
Word for word · 1
- LeonChaoX/qinyan-academic-skills★ 910100% same
Edited · 8
- wu-yc/LabClaw★ 1.1k94% same
- MarieLynneBlock/arcanum-artifex★ 498% same
- BrightGold70/skills★ 194% same
- garri333/Skills★ 194% same
- johnson7788/collect_skills★ 1100% same
- yf8578/claude-skills-collection★ 194% same
- davidanthonyn/claude-skills★ 0100% same
- Ivan-propio/claude-skills★ 0100% same
Wrote their own version · 10
- google-deepmind/science-skills★ 3.5ksame name
- jaechang-hits/SciAgent-Skills★ 386same name
- mikkelkrogsholm/skills★ 74same name
- Fmarzochi/EGC★ 61same name
- 1stANUNNAKI/majlis★ 2same name
- 1stANUNNAKI/The-Council★ 1same name
- SamuelNDCE/claude-super-skill-library★ 1same name
- uppifyagency/boilerplate-saas-2026★ 1same name
- Osmosy/vector-gene★ 0same name
- renepf/claude-skills★ 0same name
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository180 other files it gives its agents.
- bgpt-paper-searchSkill
- biorxiv-databaseSkill
- citation-managementSkill
- literature-reviewSkill
- openalex-databaseSkill
- parallel-webSkill
- perplexity-searchSkill
- pyzoteroSkill
- research-lookupSkill
- medical-imaging-reviewSkill
- paper-2-webSkill
- peer-reviewSkill
- research-proposalSkill
- scientific-writingSkill
- venue-templatesSkill
- generate-imageSkill
- infographicsSkill
- latex-postersSkill
- markdown-mermaid-writingSkill
- paper-slide-deckSkill
- pptx-postersSkill
- scientific-schematicsSkill
- scientific-slidesSkill
- scientific-visualizationSkill
- consciousness-councilSkill
- dhdna-profilerSkill
- hypothesis-generationSkill
- research-grantsSkill
- scholar-evaluationSkill
- scientific-brainstormingSkill
- scientific-critical-thinkingSkill
- what-if-oracleSkill
- anndataSkill
- arboretoSkill
- biopythonSkill
- bioservicesSkill
- cellxgene-censusSkill
- deeptoolsSkill
- etetoolkitSkill
- flowioSkill
- genimlSkill
- ggetSkill
- gtarsSkill
- lamindbSkill
- phylogeneticsSkill
- pydeseq2Skill
- pysamSkill
- scanpySkill
- scikit-bioSkill
- scveloSkill
- scvi-toolsSkill
- tiledbvcfSkill
- zarr-pythonSkill
- datamolSkill
- deepchemSkill
- diffdockSkill
- matchmsSkill
- medchemSkill
- molecular-dynamicsSkill
- molfeatSkill
- The first 60 shown.
The file
Show its rules and text
We split this skill into the rules it gives an agent
36 rules. 0 are common, 36 are distinctive, and 0 are very specific to this project.
0
Common
Most of the 18 edited versions we read keep these.
36
Distinctive
This author's own choices. Worth a look.
0
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 35
Use field tags to limit searches to specific record parts
- Distinctive: line 38
Use proximity searching for terms within specified distances
- Distinctive: line 63
Use Medical Subject Headings (MeSH) for precise, consistent searching across the biomedical literature.
- Distinctive: line 117
ESearch: - Search database and retrieve PMIDs
- Distinctive: line 156
Always include User-Agent header
- Distinctive: line 159
Use history server (usehistory=y) for large result sets
- Distinctive: line 190
Use journal name, year, volume, page, and author to find PMIDs:
- Distinctive: line 235
Start broad, review results
- Distinctive: line 236
Add specificity with field tags
- Distinctive: line 238
Use Advanced Search to view query translation
- Distinctive: line 252
Use PubMed's search history and My NCBI features for efficient research workflows.
- Distinctive: line 270
Create collections of saved articles
- Distinctive: line 274
Create RSS feeds for any search to monitor new publications in your area of interest.
- Distinctive: line 281
Every PubMed article includes pre-calculated related articles based on:
- Distinctive: line 363
Search multiple databases (include PubMed)
- Distinctive: line 364
Document search strategy and date
- Distinctive: line 371
Use history server for large result sets
- Distinctive: line 379
Start with known relevant article
- Distinctive: line 380
Use Similar Articles to find related work
- Distinctive: line 381
Check citing articles (when available)
- Distinctive: line 384
Use ELink to find related database entries
- Distinctive: line 389
Test and refine query for precision
- Distinctive: line 392
Create RSS feed for feed reader monitoring
- Distinctive: line 398
Start broad, then narrow with field tags and filters
- Distinctive: line 400
Use quotation marks for exact phrases
- Distinctive: line 401
Check Search Details in Advanced Search to verify query translation
- Distinctive: line 406
Use history server for result sets > 500 articles
- Distinctive: line 409
Always include descriptive User-Agent header
- Distinctive: line 412
Prefer systematic reviews and meta-analyses for synthesized evidence
- Distinctive: line 413
Use publication type filters to find specific study designs
- Distinctive: line 416
Use free full text filter for immediate access
- Distinctive: line 420
Use .nbib format for compatibility with most reference managers
- Distinctive: line 421
Create My NCBI account for permanent collections
- Distinctive: line 422
Document search strategies for reproducibility
- Distinctive: line 423
Use Collections to organize research by project
- Distinctive: line 435
Search history expires after 8 hours of inactivity
“Common” is measured: kept by at least 6 in 10 of the 18 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
PubMed Database
Overview
PubMed is the U.S. National Library of Medicine's comprehensive database providing free access to MEDLINE and life sciences literature. Construct advanced queries with Boolean operators, MeSH terms, and field tags, access data programmatically via E-utilities API for systematic reviews and literature analysis.
When to Use This Skill
This skill should be used when:
- Searching for biomedical or life sciences research articles
- Constructing complex search queries with Boolean operators, field tags, or MeSH terms
- Conducting systematic literature reviews or meta-analyses
- Accessing PubMed data programmatically via the E-utilities API
- Finding articles by specific criteria (author, journal, publication date, article type)
- Retrieving citation information, abstracts, or full-text articles
- Working with PMIDs (PubMed IDs) or DOIs
- Creating automated workflows for literature monitoring or data extraction
Core Capabilities
1. Advanced Search Query Construction
Construct sophisticated PubMed queries using Boolean operators, field tags, and specialized syntax.
Basic Search Strategies:
- Combine concepts with Boolean operators (AND, OR, NOT)
- Use field tags to limit searches to specific record parts
- Employ phrase searching with double quotes for exact matches
- Apply wildcards for term variations
- Use proximity searching for terms within specified distances
Example Queries:
# Recent systematic reviews on diabetes treatment
diabetes mellitus[mh] AND treatment[tiab] AND systematic review[pt] AND 2023:2024[dp]
# Clinical trials comparing two drugs
(metformin[nm] OR insulin[nm]) AND diabetes mellitus, type 2[mh] AND randomized controlled trial[pt]
# Author-specific research
smith ja[au] AND cancer[tiab] AND 2023[dp] AND english[la]When to consult search_syntax.md:
- Need comprehensive list of available field tags
- Require detailed explanation of search operators
- Constructing complex proximity searches
- Understanding automatic term mapping behavior
- Need specific syntax for date ranges, wildcards, or special characters
Grep pattern for field tags: \[au\]|\[ti\]|\[ab\]|\[mh\]|\[pt\]|\[dp\]
2. MeSH Terms and Controlled Vocabulary
Use Medical Subject Headings (MeSH) for precise, consistent searching across the biomedical literature.
MeSH Searching:
- [mh] tag searches MeSH terms with automatic inclusion of narrower terms
- [majr] tag limits to articles where the topic is the main focus
- Combine MeSH terms with subheadings for specificity (e.g., diabetes mellitus/therapy[mh])
Common MeSH Subheadings:
- /diagnosis - Diagnostic methods
- /drug therapy - Pharmaceutical treatment
- /epidemiology - Disease patterns and prevalence
- /etiology - Disease causes
- /prevention & control - Preventive measures
- /therapy - Treatment approaches
Example:
# Diabetes therapy with specific focus
diabetes mellitus, type 2[mh]/drug therapy AND cardiovascular diseases[mh]/prevention & control3. Article Type and Publication Filtering
Filter results by publication type, date, text availability, and other attributes.
Publication Types (use [pt] field tag):
- Clinical Trial
- Meta-Analysis
- Randomized Controlled Trial
- Review
- Systematic Review
- Case Reports
- Guideline
Date Filtering:
- Single year:
2024[dp] - Date range:
2020:2024[dp] - Specific date:
2024/03/15[dp]
Text Availability:
- Free full text: Add
AND free full text[sb]to query - Has abstract: Add
AND hasabstract[text]to query
Example:
# Recent free full-text RCTs on hypertension
hypertension[mh] AND randomized controlled trial[pt] AND 2023:2024[dp] AND free full text[sb]4. Programmatic Access via E-utilities API
Access PubMed data programmatically using the NCBI E-utilities REST API for automation and bulk operations.
Core API Endpoints:
- ESearch - Search database and retrieve PMIDs
- EFetch - Download full records in various formats
- ESummary - Get document summaries
- EPost - Upload UIDs for batch processing
- ELink - Find related articles and linked data
Basic Workflow:
import requests
# Step 1: Search for articles
base_url = "https://eutils.ncbi.nlm.nih.gov/entrez/eutils/"
search_url = f"{base_url}esearch.fcgi"
params = {
"db": "pubmed",
"term": "diabetes[tiab] AND 2024[dp]",
"retmax": 100,
"retmode": "json",
"api_key": "YOUR_API_KEY" # Optional but recommended
}
response = requests.get(search_url, params=params)
pmids = response.json()["esearchresult"]["idlist"]
# Step 2: Fetch article details
fetch_url = f"{base_url}efetch.fcgi"
params = {
"db": "pubmed",
"id": ",".join(pmids),
"rettype": "abstract",
"retmode": "text",
"api_key": "YOUR_API_KEY"
}
response = requests.get(fetch_url, params=params)
abstracts = response.textRate Limits:
- Without API key: 3 requests/second
- With API key: 10 requests/second
- Always include User-Agent header
Best Practices:
- Use history server (usehistory=y) for large result sets
- Implement batch operations via EPost for multiple UIDs
- Cache results locally to minimize redundant calls
- Respect rate limits to avoid service disruption
When to consult api_reference.md:
- Need detailed endpoint documentation
- Require parameter specifications for each E-utility
- Constructing batch operations or history server workflows
- Understanding response formats (XML, JSON, text)
- Troubleshooting API errors or rate limit issues
Grep pattern for API endpoints: esearch|efetch|esummary|epost|elink|einfo
5. Citation Matching and Article Retrieval
Find articles using partial citation information or specific identifiers.
By Identifier:
# By PMID
12345678[pmid]
# By DOI
10.1056/NEJMoa123456[doi]
# By PMC ID
PMC123456[pmc]Citation Matching (via ECitMatch API): Use journal name, year, volume, page, and author to find PMIDs:
Format: journal|year|volume|page|author|key|
Example: Science|2008|320|5880|1185|key1|By Author and Metadata:
# First author with year and topic
smith ja[1au] AND 2023[dp] AND cancer[tiab]
# Journal, volume, and page
nature[ta] AND 2024[dp] AND 456[vi] AND 123-130[pg]6. Systematic Literature Reviews
Conduct comprehensive literature searches for systematic reviews and meta-analyses.
PICO Framework (Population, Intervention, Comparison, Outcome): Structure clinical research questions systematically:
# Example: Diabetes treatment effectiveness
# P: diabetes mellitus, type 2[mh]
# I: metformin[nm]
# C: lifestyle modification[tiab]
# O: glycemic control[tiab]
diabetes mellitus, type 2[mh] AND
(metformin[nm] OR lifestyle modification[tiab]) AND
glycemic control[tiab] AND
randomized controlled trial[pt]Comprehensive Search Strategy:
# Include multiple synonyms and MeSH terms
(disease name[tiab] OR disease name[mh] OR synonym[tiab]) AND
(treatment[tiab] OR therapy[tiab] OR intervention[tiab]) AND
(systematic review[pt] OR meta-analysis[pt] OR randomized controlled trial[pt]) AND
2020:2024[dp] AND
english[la]Search Refinement:
- Start broad, review results
- Add specificity with field tags
- Apply date and publication type filters
- Use Advanced Search to view query translation
- Combine search history for complex queries
When to consult common_queries.md:
- Need example queries for specific disease types or research areas
- Require templates for different study designs
- Looking for population-specific query patterns (pediatric, geriatric, etc.)
- Constructing methodology-specific searches
- Need quality filters or best practice patterns
Grep pattern for query examples: diabetes|cancer|cardiovascular|clinical trial|systematic review
7. Search History and Saved Searches
Use PubMed's search history and My NCBI features for efficient research workflows.
Search History (via Advanced Search):
- Maintains up to 100 searches
- Expires after 8 hours of inactivity
- Combine previous searches using # references
- Preview result counts before executing
Example:
#1: diabetes mellitus[mh]
#2: cardiovascular diseases[mh]
#3: #1 AND #2 AND risk factors[tiab]My NCBI Features:
- Save searches indefinitely
- Set up email alerts for new matching articles
- Create collections of saved articles
- Organize research by project or topic
RSS Feeds: Create RSS feeds for any search to monitor new publications in your area of interest.
8. Related Articles and Citation Discovery
Find related research and explore citation networks.
Similar Articles Feature: Every PubMed article includes pre-calculated related articles based on:
- Title and abstract similarity
- MeSH term overlap
- Weighted algorithmic matching
ELink for Related Data:
# Find related articles programmatically
elink.fcgi?dbfrom=pubmed&db=pubmed&id=PMID&cmd=neighborCitation Links:
- LinkOut to full text from publishers
- Links to PubMed Central free articles
- Connections to related NCBI databases (GenBank, ClinicalTrials.gov, etc.)
9. Export and Citation Management
Export search results in various formats for citation management and further analysis.
Export Formats:
- .nbib files for reference managers (Zotero, Mendeley, EndNote)
- AMA, MLA, APA, NLM citation styles
- CSV for data analysis
- XML for programmatic processing
Clipboard and Collections:
- Clipboard: Temporary storage for up to 500 items (8-hour expiration)
- Collections: Permanent storage via My NCBI account
Batch Export via API:
# Export citations in MEDLINE format
efetch.fcgi?db=pubmed&id=PMID1,PMID2&rettype=medline&retmode=textWorking with Reference Files
This skill includes three comprehensive reference files in the references/ directory:
references/api_reference.md
Complete E-utilities API documentation including all nine endpoints, parameters, response formats, and best practices. Consult when:
- Implementing programmatic PubMed access
- Constructing API requests
- Understanding rate limits and authentication
- Working with large datasets via history server
- Troubleshooting API errors
references/search_syntax.md
Detailed guide to PubMed search syntax including field tags, Boolean operators, wildcards, and special characters. Consult when:
- Constructing complex search queries
- Understanding automatic term mapping
- Using advanced search features (proximity, wildcards)
- Applying filters and limits
- Troubleshooting unexpected search results
references/common_queries.md
Extensive collection of example queries for various research scenarios, disease types, and methodologies. Consult when:
- Starting a new literature search
- Need templates for specific research areas
- Looking for best practice query patterns
- Conducting systematic reviews
- Searching for specific study designs or populations
Reference Loading Strategy: Load reference files into context as needed based on the specific task. For brief queries or basic searches, the information in this SKILL.md may be sufficient. For complex operations, consult the appropriate reference file.
Common Workflows
Workflow 1: Basic Literature Search
- Identify key concepts and synonyms
- Construct query with Boolean operators and field tags
- Review initial results and refine query
- Apply filters (date, article type, language)
- Export results for analysis
Workflow 2: Systematic Review Search
- Define research question using PICO framework
- Identify all relevant MeSH terms and synonyms
- Construct comprehensive search strategy
- Search multiple databases (include PubMed)
- Document search strategy and date
- Export results for screening and review
Workflow 3: Programmatic Data Extraction
- Design search query and test in web interface
- Implement search using ESearch API
- Use history server for large result sets
- Retrieve detailed records with EFetch
- Parse XML/JSON responses
- Store data locally with caching
- Implement rate limiting and error handling
Workflow 4: Citation Discovery
- Start with known relevant article
- Use Similar Articles to find related work
- Check citing articles (when available)
- Explore MeSH terms from relevant articles
- Construct new searches based on discoveries
- Use ELink to find related database entries
Workflow 5: Ongoing Literature Monitoring
- Construct comprehensive search query
- Test and refine query for precision
- Save search to My NCBI account
- Set up email alerts for new matches
- Create RSS feed for feed reader monitoring
- Review new articles regularly
Tips and Best Practices
Search Strategy
- Start broad, then narrow with field tags and filters
- Include synonyms and MeSH terms for comprehensive coverage
- Use quotation marks for exact phrases
- Check Search Details in Advanced Search to verify query translation
- Combine multiple searches using search history
API Usage
- Obtain API key for higher rate limits (10 req/sec vs 3 req/sec)
- Use history server for result sets > 500 articles
- Implement exponential backoff for rate limit handling
- Cache results locally to minimize redundant requests
- Always include descriptive User-Agent header
Quality Filtering
- Prefer systematic reviews and meta-analyses for synthesized evidence
- Use publication type filters to find specific study designs
- Filter by date for most recent research
- Apply language filters as appropriate
- Use free full text filter for immediate access
Citation Management
- Export early and often to avoid losing search results
- Use .nbib format for compatibility with most reference managers
- Create My NCBI account for permanent collections
- Document search strategies for reproducibility
- Use Collections to organize research by project
Limitations and Considerations
Database Coverage
- Primarily biomedical and life sciences literature
- Pre-1975 articles often lack abstracts
- Full author names available from 2002 forward
- Non-English abstracts available but may default to English display
Search Limitations
- Display limited to 10,000 results maximum
- Search history expires after 8 hours of inactivity
- Clipboard holds max 500 items with 8-hour expiration
- Automatic term mapping may produce unexpected results
API Considerations
- Rate limits apply (3-10 requests/second)
- Large queries may time out (use history server)
- XML parsing required for detailed data extraction
- API key recommended for production use
Access Limitations
- PubMed provides citations and abstracts (not always full text)
- Full text access depends on publisher, institutional access, or open access status
- LinkOut availability varies by journal and institution
- Some content requires subscription or payment
Support Resources
- PubMed Help: https://pubmed.ncbi.nlm.nih.gov/help/
- E-utilities Documentation: https://www.ncbi.nlm.nih.gov/books/NBK25501/
- NLM Help Desk: 1-888-FIND-NLM (1-888-346-3656)
- Technical Support: vog.hin.mln.ibcn@seitilitue
- Mailing List: utilities-announce@ncbi.nlm.nih.gov
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

