<< All versions
Skill v1.0.0
Trusted Publisher100/100openai/plugins/ncbi-entrez-skill
──Details
PublishedApril 26, 2026 at 05:58 AM
Content Hashsha256:0786209bfbd86170...
Git SHA
──Files
Files (1 file, 2.7 KB)
SKILL.md2.7 KBactive
SKILL.md · 45 lines · 2.7 KB
version: "1.0.0" name: ncbi-entrez-skill description: Submit compact NCBI Entrez E-Utilities requests for PubMed, Gene, Protein, Nucleotide, PMC metadata, and GEO metadata workflows. Use when a user wants concise Entrez search, fetch, summary, or link results; save raw JSON or XML only on request.
Operating rules
- Use
scripts/ncbi_entrez.pyfor all Entrez calls in this package. - Use explicit
endpointvalues such asesearch,esummary,efetch,elink, oreinfo. - Search-style Entrez calls are better with
retmax=10andmax_items=10. - GEO is nested under this skill. Use
db=gdsordb=geoprofilesfor GEO metadata and loadreferences/geo.mdonly when the user is specifically asking about GEO. - BLAST workflows belong in
ncbi-blast-skill. PMC Open Access workflows belong inncbi-pmc-skill. Datasets v2 workflows belong inncbi-datasets-skill. - Re-run requests in long conversations instead of relying on older tool output.
- Treat displayed
...in tool previews as UI truncation, not literal request content.
Execution behavior
- Return concise markdown summaries from the script output by default.
- Return raw JSON or XML only if the user explicitly asks for machine-readable output.
- Prefer targeted endpoint calls instead of broad unfiltered dumps.
- If the user needs the full raw response, set
save_raw=trueand report the saved file path.
Input
- Read one JSON object from stdin.
- Required field:
endpoint - Optional fields:
params,record_path,response_format,max_items,max_depth,timeout_sec,save_raw,raw_output_path - Common Entrez patterns:
{"endpoint":"esearch","params":{"db":"pubmed","term":"KRAS AND colorectal cancer","retmode":"json","retmax":10},"max_items":10}{"endpoint":"esummary","params":{"db":"gene","id":"7157","retmode":"json"},"max_items":10}{"endpoint":"efetch","params":{"db":"protein","id":"NP_000537.3","retmode":"xml"},"response_format":"xml","max_items":10}{"endpoint":"elink","params":{"dbfrom":"gds","db":"pubmed","id":"200000001","retmode":"json"},"max_items":10}
Output
- Success returns
ok,source, endpoint metadata, and either compactrecords, a compactsummary, ortext_head. - Use
raw_output_pathwhensave_raw=true. - Failure returns
ok=falsewitherror.codeanderror.message.
Execution
bash
echo '{"endpoint":"esearch","params":{"db":"gene","term":"TP53[gene] AND human[orgn]","retmode":"json","retmax":10},"max_items":10}' | python scripts/ncbi_entrez.py
References
- Load
references/geo.mdonly when the user specifically needs GEO query patterns. - Keep the import package limited to this file,
references/geo.md, andscripts/ncbi_entrez.py.