ncbi-clinicaltables-skill

Query the NCBI Clinical Tables API for compact human gene search results.

5.3k|765|Updated Mar 4, 2026
One-click install
npx skills add https://github.com/openai/plugins --skill ncbi-clinicaltables-skill
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ncbi-clinicaltables-skill
Source: https://github.com/openai/plugins/tree/main/plugins/life-science-research/skills/ncbi-clinicaltables-skill
Command: npx skills add https://github.com/openai/plugins --skill ncbi-clinicaltables-skill

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires requests, and includes scripts (resource) components.

What problem does it solve?

Researchers often need quick, autocomplete-style human gene lookups without pulling full Entrez Gene records. This Skill submits compact requests to the NCBI Clinical Tables gene API and returns concise, paginated summaries instead of overwhelming raw payloads.

Core Features & Use Cases

  • Autocomplete-style gene search: Submit a term like TP53 or BRCA and receive matching GeneIDs, symbols, and descriptions.
  • Pagination and field selection: Control result size with count and offset, and choose returned fields via df, ef, and sf parameters.
  • Raw payload saving: Optionally save the full JSON response to a file path instead of flooding the chat with large arrays.
  • Use Case: A bioinformatics researcher wants the GeneID, symbol, and chromosome for genes matching "kinase", ten results at a time, and pages through results with offset.

Quick Start

Ask the assistant to search NCBI Clinical Tables for the gene TP53 and return the GeneID, symbol, and description for the first ten matches.

Frequently Asked Questions about ncbi-clinicaltables-skill

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I search for human genes using the NCBI Clinical Tables API?

Send a JSON object with a terms field, such as {"terms":"TP53"}, to the helper script via stdin. It queries the clinicaltables.nlm.nih.gov ncbi_genes endpoint and returns matching GeneIDs, symbols, and descriptions.

How do I paginate NCBI gene search results?

Use the count and offset parameters inside the params object, for example {"count":10,"offset":10} to fetch the second page. Keep count modest and page with offset rather than requesting large result sets at once.

When should I use Clinical Tables instead of NCBI Entrez Gene?

Use Clinical Tables when you want concise autocomplete-style search rows for human genes. Prefer an Entrez-based approach when you need full general Entrez Gene records with detailed annotations rather than search summaries.

How do I select which fields the NCBI gene search returns?

Pass the df parameter inside params, such as "df":"GeneID,Symbol,description", to choose display fields. You can also use ef and sf for extra and search field options supported by the API.

Why does the gene search script fail with a missing dependency error?

The script requires the Python requests package to call the API. If requests is not installed, it returns an error with code missing_dependency; install requests and rerun the command.

Can I save the full NCBI API response instead of a summary?

Yes, set save_raw to true in the input JSON and optionally provide raw_output_path. The full response is written to that file, defaulting to /tmp/ncbi-gene-search.json, and the path is reported in the output.