vimalinx/bio-agent / .claude/skills/ecollect
ecollect
UnverifiedUse when collecting sorted UID lists from EDirect query sources such as PubMed queries, explicit IDs, WebEnv history state, or input files.
ecollect
EDirect query-source normalizer and PubMed SOLR workaround wrapper. It can count matching PubMed records, return a limited eSearchResult subset, or emit a deduplicated UID list from query, history, inline IDs, raw rest data, or input files.
Quick Start
- Command:
ecollect - Local executable:
/home/vimalinx/miniforge3/envs/bio/bin/ecollect - Prerequisite: network access to NCBI EUtils for query and history-based modes
When To Use This Tool
- Turn
-query,-id,-input,-rest, or history-server state (-web/-key) into a normalized UID list. - Use PubMed-specific
-countor-subsethelper modes when working around large-result SOLR behavior. - Deduplicate identifiers before sending them to downstream
efetch,esummary, or other EDirect stages. - Preserve an EDirect shell workflow instead of writing your own UID-expansion logic around EUtils.
Common Patterns
# 1) Ask PubMed for just the count of matching records
PATH=/home/vimalinx/miniforge3/envs/bio/bin:$PATH \
ecollect -db pubmed -count 'BRCA1[Title]'
# 2) Retrieve a small eSearchResult XML subset for inspection
PATH=/home/vimalinx/miniforge3/envs/bio/bin:$PATH \
ecollect -db pubmed -subset 'BRCA1[Title]' -retmax 3
# 3) Normalize explicit IDs into a deduplicated UID list
PATH=/home/vimalinx/miniforge3/envs/bio/bin:$PATH \
ecollect -db pubmed -id 7 3 7 1
Recommended Workflow
- Decide which source mode you are using: PubMed query, explicit IDs, input file, raw rest payload, or history-server coordinates.
- Always set
-dbfirst so the wrapper knows which downstream semantics to apply. - Use
-countor-subsetonly when you specifically want PubMed query introspection; use the normal path when you want a final UID list. - Inspect a small sample before bulk fetches, especially if you also apply date filters or rely on history-server state.
Guardrails
-dbis mandatory. Bare invocation or incomplete argument sets fail withERROR: Missing -db argument.-helpis not a real help switch. The live result isERROR: Unrecognized argument -helpfollowed by the missing-dbcomplaint.- The wrapper appends its own bin directory to
PATHand sourcesecommon.sh, so behavior here is broader than a single network call. -countand-subsetare specialized PubMed SOLR workaround modes, not generic options for every Entrez database.- Final UID output is deduplicated through
sort -n | uniq, so original order is not preserved. -tranquilsuppresses the usualNo items foundwarning/retry handling. That is useful for expected-empty searches but easy to misuse if you need loud failures.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| brainstormingobra/superpowersYou MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation). | Stars: 318k | Updated | Claude CodeCodex | Unverified | Install |
| brand-guidelinesanthropics/skillsApplies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |
| frontend-designanthropics/skillsGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |
| mcp-builderanthropics/skillsGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK). | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |