ncbi-blast-skill
Submit, poll, and summarize NCBI BLAST Common URL API jobs (Blast.cgi) for nucleotide or protein sequences. Use when a user wants RID status, BLAST results, or compact top-hit summaries; fetch raw Text/JSON2 only on request.
- License 许可
- AGPL-3.0
- 所属仓库
- wxdwu/new-api
- 最近更新
- 2026-10-05
- Stars
- ★ 0
- Forks
- 0
01 前言 Front Matter
- name
- ncbi-blast-skill
- description
- Submit, poll, and summarize NCBI BLAST Common URL API jobs (Blast.cgi) for nucleotide or protein sequences. Use when a user wants RID status, BLAST results, or compact top-hit summaries; fetch raw Text/JSON2 only on request.
02 资源文件 5
- 参考文档agents/openai.yaml97 B
- 参考文档references/blast-common-url-api.txt2.5 KB
- 参考文档references/intent-notes.txt488 B
- 脚本scripts/ncbi_blast.py25.5 KB
- 脚本scripts/test_ncbi_blast.py16.5 KB
03 SKILL.md 正文
Operating rules
- Use
scripts/ncbi_blast.pyfor all concrete BLAST work. - Honor NCBI limits:
>=10sbetween requests and>=60sbetween polls for the same RID. - Always surface the
RIDin the response so the job can be resumed or refetched later. - If the conversation is long or multiple tool calls have occurred, refetch from the
RIDinstead of trusting older context. - If a prior turn saved raw output to disk, do not read it back into context unless the user asks for a specific follow-up.
Execution behavior
- Return compact BLAST summaries first.
- Do not paste full
JSON2or long Text alignments into chat by default. - Default to
max_hits=5andmax_queries=5. - If the user asks for raw output, write it to a file and report the path.
- Only provide Python code when the user explicitly asks for code or execution is unavailable.
- For normal user-facing answers, summarize the script JSON in markdown; if the user explicitly asks for machine-readable output, return the JSON verbatim.
Input
- The script reads one JSON object from stdin.
actionmust be one ofsubmit,status,fetch, orrun.submitandrunrequireprogram,database,query_fasta, andemail(orNCBI_EMAIL).statusandfetchrequirerid.programmust be one ofblastn,blastp,blastx,tblastn, ortblastx.result_formatdefaults tojson2forrunandfetch.tooldefaults toNCBI_TOOL, thenncbi-blast-skill.max_hitsdefaults to5;max_queriesdefaults to5.hitlist_sizedefaults to50;descriptionsandalignmentsdefault to5.wait_timeout_secdefaults to900.save_rawdefaults tofalse.- If
save_raw=trueandraw_output_pathis omitted, the script writes to/tmp/ncbi-blast-<rid>.<json|txt>. query_fastamay contain multi-FASTA input; compact summaries still cap per-query output withmax_hitsandmax_queries.
Output
- Common success fields:
ok,source,action,warnings. submitreturnsrid,rtoe_seconds, andstatus="SUBMITTED".statusreturnsrid, normalizedstatus, andhas_hits.runandfetchwithresult_format=json2returnrid,status,has_hits,result_format,query_count_returned,query_count_available,query_summaries_truncated,query_summaries, andraw_output_path.- Each
query_summarycontainsquery_title,hit_count_returned,hit_count_available,truncated, andtop_hits. - Each
top_hitcontainsrank,accession,title,evalue, andbit_score. fetchwithresult_format=textreturnstext_headcapped at 800 characters unlesssave_raw=true; whensave_raw=true, it returns only the artifact path.- Failures return
ok=false,error.code,error.message, andwarnings.
Execution
- Run
python scripts/ncbi_blast.py. - If
requestsis missing, install it once before first use withpython -m pip install requests.
echo '{"action":"run","program":"blastp","database":"swissprot","query_fasta":">q1\nMTEYK...","email":"you@example.com"}' | python scripts/ncbi_blast.py
References
- Load
references/blast-common-url-api.txtonly for parameter details or uncommon BLAST options. - Do not load
references/intent-notes.txtduring normal skill execution; it is not runtime guidance.
04 同仓库更多 Skills
Zotero
Use Zotero Desktop from Codex to enable/probe the local API, search a local Zotero library, list items/collections/tags, export BibTeX, insert citation keys into LaTeX or Markdown drafts, read indexed full text when requested, and import BibTeX/RIS records into Zotero through the connector server. Use when the user mentions Zotero, citations, references.bib, BibTeX export, local Zotero API, localhost:23119, or adding citations from a Zotero library.
zoom-apps-sdk
Use when using Apps SDK.
setup-zoom-websockets
Use when building Zoom WebSockets.
setup-zoom-webhooks
Use when building Zoom webhooks.
zoom-virtual-agent-web
Zoom Virtual Agent SDK for web embeds. Use for campaign or entry ID chat launch, event-driven controls, user context updates, and CSP-safe deployment.
zoom-virtual-agent-ios
Zoom Virtual Agent iOS integration via WKWebView. Use for Swift/Objective-C script injection, message handlers, support_handoff relay, and URL routing policies.