Index of every page on this site: llms.txt
All skills
davila7 avatar

/reactome-database

@053feb2
Run it yourself

Query Reactome REST API for pathway analysis, enrichment, gene-pathway mapping, disease pathways, molecular interactions, expression analysis, for systems biology studies.

Use this Skill: https://skilld.dev/gh/davila7/claude-code-templates/reactome-database

Nothing lands on disk. Nothing to clean up.

Fork this Skill

Edit a local copy. It keeps the author and licence.

SKILL.md

≈48 tokens for metadata: the name and description. ≈1.9k when used: this file. ≈2.6k more on demand in 1 file.

Description uses 2.4% of example budget

Before choosing a Skill, your Agent reads its name and description. All available Skills share that space.

  • A shorter description leaves more room for other Skills. This entry exceeds our 1% size suggestion.

In our Claude Code example, all Skill names and descriptions share 8,000 characters. This Skill uses ≈191 characters, or 2.4%.

The 1% threshold is a size suggestion. Longer descriptions can still fit.

Your model, settings, and other Skills decide how much text your Agent can read.

Example settings and source

The example uses a 200k-token context and default Claude Code settings. The count includes the name, description, separators, and when_to_use when present. Codex also counts local file paths.

Skit's source and limits: Codex 0.160.1, Claude Code 2.1.292.

Reactome Database

Overview

Reactome is a free, open-source, curated pathway database with 2,825+ human pathways. Query biological pathways, perform overrepresentation and expression analysis, map genes to pathways, explore molecular interactions via REST API and Python client for systems biology research.

When to Use This Skill

This skill should be used when:

  • Performing pathway enrichment analysis on gene or protein lists
  • Analyzing gene expression data to identify relevant biological pathways
  • Querying specific pathway information, reactions, or molecular interactions
  • Mapping genes or proteins to biological pathways and processes
  • Exploring disease-related pathways and mechanisms
  • Visualizing analysis results in the Reactome Pathway Browser
  • Conducting comparative pathway analysis across species

Core Capabilities

Reactome provides two main API services and a Python client library:

1. Content Service - Data Retrieval

Query and retrieve biological pathway data, molecular interactions, and entity information.

Common operations:

  • Retrieve pathway information and hierarchies
  • Query specific entities (proteins, reactions, complexes)
  • Get participating molecules in pathways
  • Access database version and metadata
  • Explore pathway compartments and locations

API Base URL: https://reactome.org/ContentService

2. Analysis Service - Pathway Analysis

Perform computational analysis on gene lists and expression data.

Analysis types:

  • Overrepresentation Analysis: Identify statistically significant pathways from gene/protein lists
  • Expression Data Analysis: Analyze gene expression datasets to find relevant pathways
  • Species Comparison: Compare pathway data across different organisms

API Base URL: https://reactome.org/AnalysisService

3. reactome2py Python Package

Python client library that wraps Reactome API calls for easier programmatic access.

Installation:

uv pip install reactome2py

Note: The reactome2py package (version 3.0.0, released January 2021) is functional but not actively maintained. For the most up-to-date functionality, consider using direct REST API calls.

Querying Pathway Data

Using Content Service REST API

The Content Service uses REST protocol and returns data in JSON or plain text formats.

Get database version:

import requests

response = requests.get("https://reactome.org/ContentService/data/database/version")
version = response.text
print(f"Reactome version: {version}")

Query a specific entity:

import requests

entity_id = "R-HSA-69278"  # Example pathway ID
response = requests.get(f"https://reactome.org/ContentService/data/query/{entity_id}")
data = response.json()

Get participating molecules in a pathway:

import requests

event_id = "R-HSA-69278"
response = requests.get(
    f"https://reactome.org/ContentService/data/event/{event_id}/participatingPhysicalEntities"
)
molecules = response.json()

Using reactome2py Package

import reactome2py
from reactome2py import content

# Query pathway information
pathway_info = content.query_by_id("R-HSA-69278")

# Get database version
version = content.get_database_version()

For detailed API endpoints and parameters, refer to references/api_reference.md in this skill.

Performing Pathway Analysis

Overrepresentation Analysis

Submit a list of gene/protein identifiers to find enriched pathways.

Using REST API:

import requests

# Prepare identifier list
identifiers = ["TP53", "BRCA1", "EGFR", "MYC"]
data = "\n".join(identifiers)

# Submit analysis
response = requests.post(
    "https://reactome.org/AnalysisService/identifiers/",
    headers={"Content-Type": "text/plain"},
    data=data
)

result = response.json()
token = result["summary"]["token"]  # Save token to retrieve results later

# Access pathways
for pathway in result["pathways"]:
    print(f"{pathway['stId']}: {pathway['name']} (p-value: {pathway['entities']['pValue']})")

Retrieve analysis by token:

# Token is valid for 7 days
response = requests.get(f"https://reactome.org/AnalysisService/token/{token}")
results = response.json()

Expression Data Analysis

Analyze gene expression datasets with quantitative values.

Input format (TSV with header starting with #):

#Gene	Sample1	Sample2	Sample3
TP53	2.5	3.1	2.8
BRCA1	1.2	1.5	1.3
EGFR	4.5	4.2	4.8

Submit expression data:

import requests

# Read TSV file
with open("expression_data.tsv", "r") as f:
    data = f.read()

response = requests.post(
    "https://reactome.org/AnalysisService/identifiers/",
    headers={"Content-Type": "text/plain"},
    data=data
)

result = response.json()

Species Projection

Map identifiers to human pathways exclusively using the /projection/ endpoint:

response = requests.post(
    "https://reactome.org/AnalysisService/identifiers/projection/",
    headers={"Content-Type": "text/plain"},
    data=data
)

Visualizing Results

Analysis results can be visualized in the Reactome Pathway Browser by constructing URLs with the analysis token:

token = result["summary"]["token"]
pathway_id = "R-HSA-69278"
url = f"https://reactome.org/PathwayBrowser/#{pathway_id}&DTAB=AN&ANALYSIS={token}"
print(f"View results: {url}")

Working with Analysis Tokens

  • Analysis tokens are valid for 7 days
  • Tokens allow retrieval of previously computed results without re-submission
  • Store tokens to access results across sessions
  • Use GET /token/{TOKEN} endpoint to retrieve results

Data Formats and Identifiers

Supported Identifier Types

Reactome accepts various identifier formats:

  • UniProt accessions (e.g., P04637)
  • Gene symbols (e.g., TP53)
  • Ensembl IDs (e.g., ENSG00000141510)
  • EntrezGene IDs (e.g., 7157)
  • ChEBI IDs for small molecules

The system automatically detects identifier types.

Input Format Requirements

For overrepresentation analysis:

  • Plain text list of identifiers (one per line)
  • OR single column in TSV format

For expression analysis:

  • TSV format with mandatory header row starting with "#"
  • Column 1: identifiers
  • Columns 2+: numeric expression values
  • Use period (.) as decimal separator

Output Format

All API responses return JSON containing:

  • pathways: Array of enriched pathways with statistical metrics
  • summary: Analysis metadata and token
  • entities: Matched and unmapped identifiers
  • Statistical values: pValue, FDR (false discovery rate)

Helper Scripts

This skill includes scripts/reactome_query.py, a helper script for common Reactome operations:

# Query pathway information
python scripts/reactome_query.py query R-HSA-69278

# Perform overrepresentation analysis
python scripts/reactome_query.py analyze gene_list.txt

# Get database version
python scripts/reactome_query.py version

Additional Resources

For comprehensive API endpoint documentation, see references/api_reference.md in this skill.

Current Database Statistics (Version 94, September 2025)

  • 2,825 human pathways
  • 16,002 reactions
  • 11,630 proteins
  • 2,176 small molecules
  • 1,070 drugs
  • 41,373 literature references

Source: SKILL.md on GitHub

skilld matched fixed text patterns in SKILL.md and file names. Patterns miss obfuscated code.

skilld run checks every file with the same patterns. It asks for approval before it loads a Skill with a behavior marked Needs approval.

1 warning1mo4 checks · Risk SAFE
  • Gen Agent Trust Hub1mo

    This skill provides biological pathway analysis using the Reactome database APIs. It is functional for systems biology research and performs standard data processing and network operations to official Reactome domains.

  • Socket1mo

    No alerts

  • Snyk1mo

    Risk: LOW · No issues

  • Runlayer9mo

    3/3 files flagged

Signed by skilld at 053feb2. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub yesterday.

Activeupdated last year

README badge

README badge for davila7/claude-code-templates/reactome-database