SkillAgentSearch skills...

human-protein-atlas-database

Use when you want to retrieve semi-quantitative protein expression and spatial localisation data from the Human Protein Atlas (HPA).

Install / Use

npx skills add google-deepmind/science-skills --skill human_protein_atlas_database

Installs into whichever agent you are using.

About this skill
📄

SKILL.md

Installable skill definition

Quality Score

93/100

Supported Platforms

Universal

Our assessment of human-protein-atlas-database

human-protein-atlas-database scores 93/100 on our quality scale, 116th of 604 Data & Analytics skills we index (top 20%).

Its SKILL.md is 6.3 KB long, well organised into 16 sections with 6 code examples: a thorough specification that gives an agent plenty to work with.

With 3,137 GitHub stars, it is one of the more widely adopted skills in the catalogue.

Substance
29/30
Structure
20/20
Description
15/15
Adoption
15/20
Freshness
15/15

Maintenance, license and trust

  • The repository was last updated about 2 months ago, so human-protein-atlas-database is actively maintained.
  • Our last check on 2026-10-26 found the source still online.
  • It is released under the Apache-2.0 license, a permissive license that allows use, modification and commercial use with attribution.
  • Its trust signals score 100/100, with no cautions. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.

Safety scan

No issues found

Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.

AI review by kimi-k2.7-code on 2026-09-29. Automated pattern scan on 2026-09-29. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.

human-protein-atlas-database compared with similar skills

All 4 of these similar skills score higher than human-protein-atlas-database; compare them before choosing.

SkillScoreStarsUpdatedFormat
human-protein-atlas-database (this skill)by google-deepmind933.1k2mo agoSKILL.md
x402by browser-use100121.0k3d agoSKILL.md
algorithmic-artby anthropics100177.9k55d agoSKILL.md
pptxby anthropics100177.9k55d agoSKILL.md
designby nextlevelbuilder100149.0k6d agoSKILL.md

Frequently asked questions

How do I install human-protein-atlas-database?
Run npx skills add google-deepmind/science-skills --skill human-protein-atlas-database. The install tabs above show the steps for each supported agent.
Which AI agents does human-protein-atlas-database work with?
It is written for Universal, as a SKILL.md file. Other agents that read the same format can often use it too.
Is human-protein-atlas-database safe to use?
Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It is Apache-2.0-licensed and scores 100/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
Is human-protein-atlas-database still maintained?
The repository was last updated about 2 months ago, so human-protein-atlas-database is actively maintained.

name: human-protein-atlas-database description: > Use when you want to retrieve semi-quantitative protein expression and spatial localisation data from the Human Protein Atlas (HPA).

Human Protein Atlas (HPA) Database Integration

This skill provides semi-quantitative protein expression and spatial localisation data from the Human Protein Atlas (HPA). While RNA-seq (e.g., GTEx) tells us if a gene is being transcribed, HPA confirms if the protein product actually exists, where it is located within the cell (e.g. nucleus vs cytoplasm), and its concentration in systemic blood circulation. The data is based on Immunohistochemistry (IHC) across normal human tissues and cancer types.

Prerequisites

  1. uv: Read the uv skill and follow its Setup instructions to ensure uv is installed and on PATH.
  2. User Notification: If .licenses/human_protein_atlas_database_LICENSE.txt does not already exist in the workspace root directory then (1) prominently notify the user to check the terms at https://www.proteinatlas.org/about/licence, then (2) create the file recording the notification text and timestamp.

When to Use

Use this skill when you need to:

  • Map a gene symbol to its Ensembl ID for HPA queries.
  • Retrieve the semi-quantitative protein abundance in normal human tissues and cancer types based on IHC staining (High, Medium, Low, or Not Detected).
  • Find the specific organelles or subcellular structures where a protein has been localized (e.g., nucleoplasm, mitochondria).
  • Check the consistency/agreement between RNA-seq consensus and protein expression levels.
  • Search for genes based on specific protein expression criteria (e.g., "elevated in amygdala" or "secreted proteins").

Do NOT use when you need to:

  • Query eQTLs, pQTLs, or any variant-level associations. HPA provides wild-type expression data and knows nothing about QTLs.
  • Query gene expression in non-human species. HPA is strictly for human proteins.
  • Retrieve purely quantitative RNA expression without interest in the protein product (consider using the GTEx skill instead).

Command Selection Guide

Pick the right command on the first try. Match the user's input to the correct subcommand below.

  • Map a gene symbol to Ensembl ID: resolve-ensembl-id
  • Get tissue protein expression levels: get-tissue-expression
  • Get subcellular location of a protein: get-subcellular-location
  • Get the full HPA metadata entry for a gene: get-atlas-entry
  • Search HPA for genes matching specific criteria: search-hpa

Quick Start

# Map the ERBB2 gene symbol to its Ensembl ID
uv run scripts/hpa_cli.py resolve-ensembl-id ERBB2 --output /tmp/erbb2_id.json

# Get subcellular location by Ensembl ID
uv run scripts/hpa_cli.py get-subcellular-location ENSG00000141736 --output /tmp/erbb2_location.json

All subcommands write JSON to disk. Always save output in the /tmp/ directory. The default output file is /tmp/hpa_output.json if --output is not specified.

Commands

1. resolve-ensembl-id — Gene Symbol → Ensembl ID

Maps a common gene symbol (e.g., "TP53", "ERBB2") to its Ensembl gene ID. HPA endpoints are strictly Ensembl-based.

uv run scripts/hpa_cli.py resolve-ensembl-id TP53 --output /tmp/tp53_id.json

Arguments:

  • gene_symbol (positional): The standard gene symbol (e.g., "TP53").
  • --output: Output file path (default: /tmp/hpa_output.json).

2. get-tissue-expression — Get Tissue Protein Levels

Returns a list of tissues and their corresponding protein expression levels (High, Medium, Low, or Not Detected) based on IHC staining.

uv run scripts/hpa_cli.py get-tissue-expression ENSG00000130234 \
  --tissues "duodenum,thyroid gland" --output /tmp/tissue_expr.json

Arguments:

  • ensembl_id (positional): The Ensembl Gene ID.
  • --tissues: Comma-separated list of tissues to filter by (optional, defaults to all available tissues).
  • --output: Output file path (default: /tmp/hpa_output.json).

3. get-subcellular-location — Get Subcellular Location

Retrieves the specific organelles or cellular structures where the protein has been localized.

uv run scripts/hpa_cli.py get-subcellular-location ENSG00000141736 \
  --output /tmp/subcellular.json

Arguments:

  • ensembl_id (positional): The Ensembl Gene ID.
  • --output: Output file path.

4. get-atlas-entry — Get Full HPA Entry

Fetches the full metadata for a gene, including IHC scores, RNA-seq consensus, and subcellular location.

uv run scripts/hpa_cli.py get-atlas-entry ENSG00000254647 \
  --output /tmp/ins_entry.json

Arguments:

  • ensembl_id (positional): The Ensembl Gene ID.
  • --format: Format of the returned entry, e.g., json (default: json).
  • --output: Output file path.

5. search-hpa — Search by Attribute

Allows filtering for genes based on specific criteria (e.g., "elevated in amygdala").

uv run scripts/hpa_cli.py search-hpa \
  --query "brain_category_rna:amygdala" \
  --output /tmp/search_results.json

Arguments:

  • --query: The search query string. Refer to references/search-api.md for details.
  • --output: Output file path.

Core Rules

  • Use the Wrapper: ALWAYS execute the provided helper scripts to query the database rather than accessing the database directly. The scripts automatically enforce fair use and implement retry logic.
  • Notification: If this skill is used, ensure this is mentioned in the output.

API Versioning

The HPA website at www.proteinatlas.org always serves the latest data release. Older archived versions can be accessed via vNN.proteinatlas.org (e.g., v24.proteinatlas.org), while the current version's subdomain redirects to www.proteinatlas.org. This skill's scripts query the latest version by default.

Common Errors

  • If no results are returned, confirm the query is detailed enough starting with the api reference in references/search-api.md
  • If you cannot find the results, search the web for example HPA queries and use these to construct a better query.
  • The output is usually large. Use jq or write your own python data parsing library to process the search results. Never output to stdout, or cat the output file.

Related Skills

View on GitHub
GitHub Stars3.1k
CategoryData
Updated2mo ago
Forks351

Languages

Python

Trust signals

100/100

From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.

No cautions