google-deepmind/science-skills

jaspar-database

Query the JASPAR database for Transcription Factor (TF) binding profiles.

Zobacz źródło

Jak używać

  1. Skopiuj polecenie instalacji i sprawdź źródła przed instalacją we własnym środowisku agenta.
  2. W oryginale sprawdź wymagane narzędzia, dane dostępowe i obsługiwane środowiska.
  3. Opisz dane wejściowe i oczekiwany rezultat; porównaj wynik ze źródłami.
npx skills add https://github.com/google-deepmind/science-skills --skill jaspar-database

Przed rozpoczęciem

  • Instalacja nie obejmuje subskrypcji modelu, limitu API ani uprawnień do plików.
  • Gwiazdki i instalacje pokazują aktywność, a nie niezależny test jakości lub bezpieczeństwa.
Oryginalny dokument Skill

Treść z repozytorium z zachowaniem nagłówków, przykładów, kodu, tabel, linków i obrazów.

JASPAR Skill

JASPAR is the definitive open-access database for Transcription Factor (TF) binding profiles, stored as Position Frequency Matrices (PFMs).

Use this skill to map abstract sequence motifs or genomic regions to specific biological regulators (e.g., "what TFs bind here?" or "what is the motif for CTCF?").

Prerequisites

  1. `uv`: Read the uv skill and follow its Setup instructions to ensure

uv is installed and on PATH.

  1. User Notification: If .licenses/jaspardatabaseLICENSE.txt does not

already exist in the workspace root directory then (1) prominently notify the user to check the terms at https://jaspar.elixir.no/ and https://jaspar.elixir.no/api/, then (2) create the file recording the notification text and timestamp.

Core Rules

CRITICAL: You MUST respect the JASPAR API Terms of Use by adhering to the following:

  • Use the Wrapper: ALWAYS execute the provided helper scripts to query the

database rather than accessing the database directly. The scripts automatically enforce the required rate limit gracefully.

  • Maximum API Window Size: The genomic window for a single API query MUST

NOT exceed 100,000 bp (100kb). The jaspar_api.py script automatically chunks larger requests for you to bypass this limitation when querying larger regions.

  • Valid Matrix IDs: get_tf_motif, get_tf_metadata, and get_tf_pwm

require a stable JASPAR Matrix ID (e.g., MA0488.2). If a user provides a gene symbol (e.g., JUN), you must resolve it first using resolve_tf_id.

  • Taxonomy Required: Resolving IDs requires a tax_id to ensure targeted

searches. Common IDs: Human=9606, Mouse=10090.

  • Notification: If this skill is used, ensure this is mentioned in the

output.

Utility Scripts

Run all commands using the bundled Python script:

1. Resolve TF to Matrix ID

Maps a transcription factor name to a stable Matrix ID. Required step before fetching motifs if only a gene name is provided.

bash
uv run scripts/jaspar_api.py resolve_tf_id --name "JUN" --tax-id 9606

2. Get TF Motif (PFM)

Retrieves the raw Position Frequency Matrix for a specific TF. Supports --format flag.

bash
uv run scripts/jaspar_api.py get_tf_motif --matrix-id "MA0488.2"
uv run scripts/jaspar_api.py get_tf_motif --matrix-id "MA0488.2" --format meme

3. Get TF Metadata

Retrieves TF class, family, and links to external databases (e.g., UniProt). Supports --format flag.

bash
uv run scripts/jaspar_api.py get_tf_metadata --matrix-id "MA0488.2"
uv run scripts/jaspar_api.py get_tf_metadata --matrix-id "MA0488.2" --format yaml

4. Compute PWM (Position Weight Matrix)

Fetches the PFM for a matrix and converts it to log-odds scores (PWM).

bash
uv run scripts/jaspar_api.py get_tf_pwm --matrix-id "MA0488.2"
uv run scripts/jaspar_api.py get_tf_pwm --matrix-id "MA0488.2" --pseudocount 0.1

5. Infer Matrix from Protein Sequence

Infers potential JASPAR matrix profiles from a raw transcription factor protein sequence.

bash
uv run scripts/jaspar_api.py infer_from_sequence --sequence "QAQLLPSHHVG"

6. Get TF Flexible Model (TFFM)

Retrieves metadata for a JASPAR TF Flexible Model. (Note: The JASPAR TFFM endpoints occasionally experience 500 Internal Server errors).

bash
uv run scripts/jaspar_api.py get_tffm --tffm-id "TFFM0001.1"

Output Formats

The get_tf_motif and get_tf_metadata commands accept an optional --format flag. Supported formats: json (default), jsonp, jaspar, meme, transfac, pfm, yaml.

Anti-Patterns

  • DON'T pass gene symbols (e.g., JUN) to get_tf_motif. You must pass

the MA... Matrix ID.

  • DON'T forget the --tax-id when resolving a TF name.
  • DON'T use this skill for determining tissue-specific epigenetic

availability (JASPAR shows potential binding, not actual tissue expression context).

  • DON'T use this skill to model how a specific protein mutation affects

binding.

z tego samego repozytorium

Więcej Skills

Wszystkie Skills
google-deepmind
Społeczność

clinical-trials-database

Query ClinicalTrials.gov via APIv2. Use when you want to search for trials by condition, drug, location, status, or phase; retrieve trial details by NCT ID; check eligibility/inclusion criteria; count trials across conditions or time periods; identify a sponsor's trial portfolio; find recruiting trials for patient matching.

Instalacje / 1h
1
GitHub Stars
3,5 tys.
Aktualizacja
10 lis
google-deepmind
Społeczność

opentargets-database

Query Open Targets Platform for target-disease associations, drug target discovery, tractability/safety data, genetics/omics evidence, known drugs, for therapeutic target identification.

Instalacje / 1h
1
GitHub Stars
3,5 tys.
Aktualizacja
10 lis
google-deepmind
Społeczność

pubchem-database

Query PubChem, search by name/CID/SMILES, retrieve properties, similarity/substructure searches, bioactivity, for cheminformatics. Use when a user asks about a specific chemical, drug, or molecule.

Instalacje / 1h
1
GitHub Stars
3,5 tys.
Aktualizacja
10 lis
google-deepmind
Społeczność

alphagenome-atlas-website-links

Constructs deep-links and URLs for the AlphaGenome Atlas website. Supports generating single-variant exploration links (1-based VCF-style coordinates), genomic locus views (1-based closed chr:start-end), candidate summary tables, and AlphaGenome reference vs. alternate predictions. Use when visualizing, exploring, charting, or linking genetic variants and genomic loci on the AlphaGenome Atlas, or when asked to inspect, view, or link predictions for a genomic variant. Don't use for computing raw

Instalacje / 1h
1
GitHub Stars
3,5 tys.
Aktualizacja
10 lis