biomate-ai/biomate-bioconductor-kb/immunotation

Claude Code and agent skill by biomate-ai/biomate-bioconductor-kb

Trust tier 2
  • community
LLM review pending
Source check pending

Checking that the SKILL.md file is still in the repository.

MHC (major histocompatibility complex) molecules are cell surface complexes that present antigens to T cells. The repertoire of antigens presented in a given genetic background largely depends on the sequence of the encoded MHC molecules, and thus, in humans, on the highly variable HLA (human leukocyte antigen) genes of the hyperpolymorphic HLA locus. More than 28,000 different HLA alleles have been reported, with significant differences in allele frequencies between human populations worldwide

Install

npx vskill@latest install biomate-ai/biomate-bioconductor-kb/immunotation

SKILL.md

The same SKILL.md was published earlier as biomate-ai/biomate-bioconductor-kb/immunotation.

immunotation

Workflows

Standard Workflow
r
library(immunotation)
# 1. Retrieve valid organisms and chain lookup table for humans
organisms <- get_valid_organisms()
human_chains <- retrieve_chain_lookup_table(organism = "human")
# 2. Map HLA alleles to serotypes and NetMHCpan inputs
allele_list <- c("A*01:01:01", "A*02:01:01", "B*39:01:01")
serotypes <- get_serotypes(allele_list, mhc_type = "MHC-I")
mhcpan_input <- get_mhcpan_input(allele_list, mhc_class = "MHC-I")
# 3. Query allele frequencies in global populations
freq_data <- query_allele_frequencies(
hla_selection = "A*02:01",
hla_sample_size_pattern = "bigger_than",
hla_sample_size = 10000,
standard = "g"
)

Input/Output Note: Inputs are HLA allele lists and population query parameters; outputs are serotypes, tool-compatible HLA strings, and population frequency tables.

When to Use

  • Converting HLA allele names to serotypes using get_serotypes.
  • Formatting HLA alleles for immunoinformatics tools like NetMHCpan using get_mhcpan_input.
  • Mapping HLA alleles to G groups (get_G_group) or P groups (get_P_group).
  • Querying HLA allele and haplotype frequencies from the Allele Frequency Net Database (AFND) using query_allele_frequencies and query_haplotype_frequencies.
  • Visualizing global allele frequency distributions on a world map using plot_allele_frequency.

When NOT to Use

  • For predicting peptide-MHC binding directly (use tools like NetMHCpan; immunotation only formats the inputs).
  • For non-MHC/HLA gene annotations.

Data Requirements

  • Character vectors of HLA allele names in standard WHO nomenclature (e.g., "A*01:01:01").

Key Parameters

  • organism: Species name (e.g., "human", "mouse") used in retrieve_chain_lookup_table.
  • mhc_type: MHC class type ("MHC-I" or "MHC-II") used in get_serotypes.
  • mhc_class: MHC class ("MHC-I" or "MHC-II") used in get_mhcpan_input.
  • hla_selection: HLA allele or allele group to query.
  • hla_sample_size_pattern: Pattern for filtering sample size (e.g., "bigger_than").
  • hla_sample_size: Minimum sample size for population queries.
  • standard: AFND data standard quality filter (e.g., "g" for Gold, "s" for Silver, "b" for Bronze).

Best Practices

  • Use get_valid_organisms to check if a species is supported before building a lookup table.
  • Convert alleles to G or P groups using get_G_group or get_P_group to resolve ambiguous HLA typings.
  • Filter AFND queries using standard = "g" (Gold standard) to ensure high-quality allele frequency data.

Common Pitfalls

  • Querying MHC-II serotypes with incomplete alpha/beta chain annotations, which returns NA. Ensure both chains are annotated in the MHC restriction ontology (MRO).

Alternatives

  • HLAtools: For general HLA data manipulation and analysis.

Citations

  • Robinson J, Barker DJ, Georgiou X et al. IPD-IMGT/HLA Database. Nucleic Acids Research (2020)
  • Gonzalez-Galarza FF, McCabe A, Santos EJ at al. Allele frequency net database (AFND) 2020 update. Nucleic Acids Research (2020)

References

  • Homepage: bioconductor.org/packages/immunotation
  • Vignette: https://bioconductor.org/packages/release/bioc/vignettes/immunotation/inst/doc/immunotation.html

Security

  • Security scanPassed, 100 of 100Pattern checks on the skill's files.
  • Model reviewNot runA model review is scheduled for the next rescan.

Quality evaluation

  • Task evaluationNot runNo evaluation yet. Run one in Skill Studio.

Source

Popularity

Repository stars
805
Repository forks
67
7-day trend score
33

Stars and forks are for the whole GitHub repository, not this skill alone. Not refreshed yet.

Works with

Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.

  • Claude Code
  • Cursor
  • GitHub Copilot
  • Windsurf
  • Codex
  • Gemini CLI
  • Cline
  • Amp
  • Roo Code
  • Goose
  • Continue
  • Kilo Code
  • Junie
  • Trae
  • OpenHands
  • Qwen Code
  • AI Agent
  • Tabnine Chat
  • Sourcegraph Cody
  • Amazon Q
  • Firebase Genkit
  • Sweep
  • Devin
  • Phind
  • Mentat
  • Claude Desktop
  • Aider
  • GPT Pilot
  • Plandex
  • bolt.new
  • v0
  • Replit Agent
  • Anse
  • TypingMind
  • BetterChatGPT
  • LibreChat
  • Warp AI
  • Pieces
  • Fig AI
Embed badge
vskill VERIFIED badge
[![vskill VERIFIED](https://verified-skill.com/api/v1/skills/biomate-ai/biomate-bioconductor-kb/immunotation/badge)](https://verified-skill.com/skills/biomate-ai/biomate-bioconductor-kb/immunotation)

Something wrong with this skill or its page? Tell us.