Claude Skill

alterlab-gget

Run fast one-liner queries to 20+ bioinformatics databases from the gget CLI or Python — gene info (Ensembl), BLAST, AlphaFold structures, Enrichr enrichment, and more. Use for quick interactive lookups of genes, sequences, structures, or pathways — for batch processing or advanc

LLM Mart · 0 points · 1 views 0 listing impressions 0 install-command copies
Download AlterLab-IEU-AlterLab-Academic-Skills-skills_bioinformatics_alterlab-gget-3ab6d03.zip · 31 KB

Install

skills CLI npx skills add https://github.com/AlterLab-IEU/AlterLab-Academic-Skills/tree/main/skills/bioinformatics/alterlab-gget
Claude Code claude plugin marketplace add https://llmmart.ai/marketplace.json && claude plugin install alterlab-ieu-alterlab-academic-skills@llmmart
Git git clone https://github.com/AlterLab-IEU/AlterLab-Academic-Skills.git

The skills CLI installs just this skill, for any of its supported agents. Claude Code installs the whole alterlab-ieu/alterlab-academic-skills collection as a plugin from our marketplace. Git is the plain clone.

Skill manifest

gget

Overview

gget is a command-line bioinformatics tool and Python package providing unified access to 20+ genomic databases and analysis methods. Query gene information, sequence analysis, protein structures, expression data, and disease associations through a consistent interface. All gget modules work both as command-line tools and as Python functions.

Project home: development moved to the scverse organisation (github.com/scverse/gget); the manual stays at pachterlab.github.io/gget.

Important: The databases queried by gget are continuously updated, which sometimes changes their structure. gget modules are tested automatically on a biweekly basis and updated to match new database structures when necessary.

Installation

Install gget in a clean virtual environment to avoid conflicts:

# Install (or upgrade) into a clean environment
uv pip install --upgrade gget

# In Python/Jupyter
import gget

Quick Start

Basic usage pattern for all modules:

# Command-line
gget <module> [arguments] [options]

# Python
gget.module(arguments, options)

Most modules return:

  • Command-line: JSON (default) or CSV with -csv flag
  • Python: DataFrame or dictionary

Common flags across modules:

  • -o/--out: Save results to file
  • -q/--quiet: Suppress progress information
  • -csv: Return CSV format (command-line only)

Module Catalog

Pick a module, then see references/module_examples.md for worked CLI + Python examples and references/module_reference.md for the full parameter table.

Module Purpose Queried source
ref Reference genome download links/metadata Ensembl
search Find genes by name/description Ensembl
info Gene/transcript metadata (~1000 IDs max) Ensembl, UniProt, NCBI
seq Nucleotide/amino-acid sequences (FASTA) Ensembl
blast BLAST against standard databases NCBI BLAST
blat Genomic position of a sequence UCSC BLAT
muscle Multiple sequence alignment Muscle5 (local)
diamond Fast local protein/translated alignment DIAMOND (local)
pdb Experimental protein structures + metadata RCSB PDB
alphafold Predict 3D protein structure (setup req.) AlphaFold2 (local)
elm Eukaryotic linear motifs (setup req.) ELM
archs4 Correlated genes / tissue expression ARCHS4
cellxgene Single-cell RNA-seq (setup req.) CZ CELLxGENE Census
enrichr Ontology/pathway enrichment Enrichr
bgee Orthologs and expression Bgee
opentargets Disease/drug associations OpenTargets
cbio Cancer genomics heatmaps cBioPortal
cosmic Somatic cancer mutations (license/account) COSMIC
mutate Generate mutated sequences local
virus Download filtered virus genome datasets NCBI Virus
g2p Residue-level structural/functional annotations Genomics 2 Proteins portal
gene_expression Mean/variance of normalized expression per partition 8cubeDB
psi_block ψ_block block-level specificity scores 8cubeDB
specificity Gene-level ψ / ζ specificity statistics 8cubeDB
gpt Natural-language text generation (setup req.) OpenAI API
setup Install third-party deps for a module local

cbio is exposed in Python as gget.cbio_search() and gget.cbio_plot().

Setup-required modules (gget setup <module> before first use): alphafold (~4GB params, needs uv pip install openmm first), cellxgene, elm, gpt, and cbio.

When to Use This Skill

  • Quick interactive lookup (gene info, BLAST, one structure, one enrichment) → use gget directly; see references/module_examples.md.
  • Batch processing / advanced BLAST → use the biopython skill.
  • Multi-database Python workflows → use the bioservices skill.

Does NOT Trigger

Scenario Use Instead
Local BLAST+ database builds and large CLI searches alterlab-blast
Scripted Entrez/SeqIO pipelines and file parsing alterlab-biopython
One workflow spanning many web services in Python alterlab-bioservices
Serious CELLxGENE Census querying beyond a one-liner alterlab-cellxgene
Running AlphaFold properly (complexes, confidence analysis) alterlab-alphafold

Hand-off rule. When the request matches a row above, open your answer by naming that skill by its exact id (for example alterlab-blast) and saying in one line why it fits better, then stop applying this skill's procedure. Name it even when you also need to ask for missing input. If only part of the request is out of scope, name the skill for that part and do only the in-scope part. A brief general pointer is fine; the named skill does the work.

  • Chaining several gget modules into a pipeline → see references/workflows.md and the ready-made scripts/ (gene_analysis, batch_sequence_analysis, enrichment_pipeline).

Best Practices (essentials)

  • Use --limit to bound large queries; save with -o/--out for reproducibility.
  • Gene symbols are case-sensitive in cellxgene ('PAX7' vs 'Pax7').
  • Run gget setup before first use of alphafold, cellxgene, elm, gpt.
  • Process max ~1000 Ensembl IDs at once with gget info.
  • Database structures change; keep gget updated: uv pip install --upgrade gget.
  • Use virtual environments to avoid dependency conflicts.

Output Formats

  • Command-line: JSON default; -csv for CSV; FASTA (seq, mutate); PDB (pdb, alphafold); PNG (cbio plot).
  • Python: DataFrame/dict default; json=True for JSON; save=True or out="filename" to write; AnnData for cellxgene.

References

  • references/module_examples.md — worked CLI + Python examples for every module
  • references/module_reference.md — full parameter tables for all modules
  • references/database_info.md — queried databases and their update frequencies
  • references/workflows.md — extended multi-module workflow examples

For additional help:

Part of the AlterLab Academic Skills suite.

Files (alterlab-academic-skills)
  • evals
    • evals.json 4.1 KB
      Loading…
  • references
    • database_info.md 10 KB
      Loading…
    • module_examples.md 10.1 KB
      Loading…
    • module_reference.md 18 KB
      Loading…
    • workflows.md 25.2 KB
      Loading…
  • scripts
    • batch_sequence_analysis.py 5.9 KB
      Loading…
    • enrichment_pipeline.py 7 KB
      Loading…
    • gene_analysis.py 5.6 KB
      Loading…
  • SKILL.md 7.5 KB
    ---
    name: alterlab-gget
    description: "Run fast one-liner queries to 20+ bioinformatics databases from the gget CLI or Python — gene info (Ensembl), BLAST, AlphaFold structures, Enrichr enrichment, and more. Use for quick interactive lookups of genes, sequences, structures, or pathways — for batch processing or advanced BLAST use biopython, for multi-database Python workflows use bioservices. Part of the AlterLab Academic Skills suite."
    license: MIT
    allowed-tools: Read Write Edit Bash(python:*) Bash(uv:*)
    compatibility: "No API key required: the core modules (info, search, seq, ref, blast, blat, pdb, alphafold, enrichr, archs4, opentargets, bgee, ...) query public databases with no account, under `uv pip install gget` (0.30.8 as of 2026-09; Python >= 3.12). Two optional modules can use a credential — cosmic (a COSMIC account for licensed somatic-mutation data) and gpt (an OpenAI key) — and alphafold, cellxgene, elm, gpt and cbio run a one-time `gget setup <module>` first."
    metadata:
        skill-author: AlterLab
        credentials: "optional: COSMIC account email/password (cosmic module's licensed somatic-mutation data; every other module is keyless); OPENAI_API_KEY (gpt module's text generation)"
        version: "1.1.1"
        last_updated: "2026-09-23"
    ---
    
    # gget
    
    ## Overview
    
    gget is a command-line bioinformatics tool and Python package providing unified access to 20+ genomic databases and analysis methods. Query gene information, sequence analysis, protein structures, expression data, and disease associations through a consistent interface. All gget modules work both as command-line tools and as Python functions.
    
    **Project home:** development moved to the scverse organisation (`github.com/scverse/gget`); the manual stays at `pachterlab.github.io/gget`.
    
    **Important**: The databases queried by gget are continuously updated, which sometimes changes their structure. gget modules are tested automatically on a biweekly basis and updated to match new database structures when necessary.
    
    ## Installation
    
    Install gget in a clean virtual environment to avoid conflicts:
    
    ```bash
    # Install (or upgrade) into a clean environment
    uv pip install --upgrade gget
    
    # In Python/Jupyter
    import gget
    ```
    
    ## Quick Start
    
    Basic usage pattern for all modules:
    
    ```bash
    # Command-line
    gget <module> [arguments] [options]
    
    # Python
    gget.module(arguments, options)
    ```
    
    Most modules return:
    - **Command-line**: JSON (default) or CSV with `-csv` flag
    - **Python**: DataFrame or dictionary
    
    Common flags across modules:
    - `-o/--out`: Save results to file
    - `-q/--quiet`: Suppress progress information
    - `-csv`: Return CSV format (command-line only)
    
    ## Module Catalog
    
    Pick a module, then see `references/module_examples.md` for worked CLI + Python
    examples and `references/module_reference.md` for the full parameter table.
    
    | Module | Purpose | Queried source |
    |--------|---------|----------------|
    | `ref` | Reference genome download links/metadata | Ensembl |
    | `search` | Find genes by name/description | Ensembl |
    | `info` | Gene/transcript metadata (~1000 IDs max) | Ensembl, UniProt, NCBI |
    | `seq` | Nucleotide/amino-acid sequences (FASTA) | Ensembl |
    | `blast` | BLAST against standard databases | NCBI BLAST |
    | `blat` | Genomic position of a sequence | UCSC BLAT |
    | `muscle` | Multiple sequence alignment | Muscle5 (local) |
    | `diamond` | Fast local protein/translated alignment | DIAMOND (local) |
    | `pdb` | Experimental protein structures + metadata | RCSB PDB |
    | `alphafold` | Predict 3D protein structure (setup req.) | AlphaFold2 (local) |
    | `elm` | Eukaryotic linear motifs (setup req.) | ELM |
    | `archs4` | Correlated genes / tissue expression | ARCHS4 |
    | `cellxgene` | Single-cell RNA-seq (setup req.) | CZ CELLxGENE Census |
    | `enrichr` | Ontology/pathway enrichment | Enrichr |
    | `bgee` | Orthologs and expression | Bgee |
    | `opentargets` | Disease/drug associations | OpenTargets |
    | `cbio` | Cancer genomics heatmaps | cBioPortal |
    | `cosmic` | Somatic cancer mutations (license/account) | COSMIC |
    | `mutate` | Generate mutated sequences | local |
    | `virus` | Download filtered virus genome datasets | NCBI Virus |
    | `g2p` | Residue-level structural/functional annotations | Genomics 2 Proteins portal |
    | `gene_expression` | Mean/variance of normalized expression per partition | 8cubeDB |
    | `psi_block` | ψ_block block-level specificity scores | 8cubeDB |
    | `specificity` | Gene-level ψ / ζ specificity statistics | 8cubeDB |
    | `gpt` | Natural-language text generation (setup req.) | OpenAI API |
    | `setup` | Install third-party deps for a module | local |
    
    `cbio` is exposed in Python as `gget.cbio_search()` and `gget.cbio_plot()`.
    
    **Setup-required modules** (`gget setup <module>` before first use):
    `alphafold` (~4GB params, needs `uv pip install openmm` first), `cellxgene`,
    `elm`, `gpt`, and `cbio`.
    
    ## When to Use This Skill
    
    - **Quick interactive lookup** (gene info, BLAST, one structure, one enrichment) →
      use gget directly; see `references/module_examples.md`.
    - **Batch processing / advanced BLAST** → use the **biopython** skill.
    - **Multi-database Python workflows** → use the **bioservices** skill.
    
    ### Does NOT Trigger
    
    | Scenario | Use Instead |
    |----------|-------------|
    | Local BLAST+ database builds and large CLI searches | `alterlab-blast` |
    | Scripted Entrez/SeqIO pipelines and file parsing | `alterlab-biopython` |
    | One workflow spanning many web services in Python | `alterlab-bioservices` |
    | Serious CELLxGENE Census querying beyond a one-liner | `alterlab-cellxgene` |
    | Running AlphaFold properly (complexes, confidence analysis) | `alterlab-alphafold` |
    
    **Hand-off rule.** When the request matches a row above, open your answer by naming that skill by its exact id (for example `alterlab-blast`) and saying in one line why it fits better, then stop applying this skill's procedure. Name it even when you also need to ask for missing input. If only part of the request is out of scope, name the skill for that part and do only the in-scope part. A brief general pointer is fine; the named skill does the work.
    - **Chaining several gget modules into a pipeline** → see `references/workflows.md`
      and the ready-made `scripts/` (gene_analysis, batch_sequence_analysis,
      enrichment_pipeline).
    
    ## Best Practices (essentials)
    
    - Use `--limit` to bound large queries; save with `-o/--out` for reproducibility.
    - Gene symbols are **case-sensitive** in cellxgene ('PAX7' vs 'Pax7').
    - Run `gget setup` before first use of alphafold, cellxgene, elm, gpt.
    - Process max ~1000 Ensembl IDs at once with `gget info`.
    - Database structures change; keep gget updated: `uv pip install --upgrade gget`.
    - Use virtual environments to avoid dependency conflicts.
    
    ## Output Formats
    
    - **Command-line**: JSON default; `-csv` for CSV; FASTA (`seq`, `mutate`);
      PDB (`pdb`, `alphafold`); PNG (`cbio plot`).
    - **Python**: DataFrame/dict default; `json=True` for JSON; `save=True` or
      `out="filename"` to write; AnnData for `cellxgene`.
    
    ## References
    
    - `references/module_examples.md` — worked CLI + Python examples for every module
    - `references/module_reference.md` — full parameter tables for all modules
    - `references/database_info.md` — queried databases and their update frequencies
    - `references/workflows.md` — extended multi-module workflow examples
    
    For additional help:
    - Official documentation: https://pachterlab.github.io/gget/
    - GitHub issues: https://github.com/pachterlab/gget/issues
    - Citation: Luebbert, L. & Pachter, L. (2023). Efficient querying of genomic reference databases with gget. Bioinformatics. https://doi.org/10.1093/bioinformatics/btac836
    
    Part of the AlterLab Academic Skills suite.
    

Comments (0)

Sign in to join the conversation.

No comments yet.

Reviews (0)

No reviews yet.