bio-tcr-bcr-analysis-vdjtools-analysis

Compute immune repertoire diversity metrics, overlap, and clonotype tracking with VDJtools.

Updated Mar 30, 2026
One-click install
npx skills add https://github.com/ya-way/cytoclaw-skills --skill bio-tcr-bcr-analysis-vdjtools-analysis
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bio-tcr-bcr-analysis-vdjtools-analysis
Source: https://github.com/ya-way/cytoclaw-skills/tree/main/workspace/skills/bio-tcr-bcr-analysis-vdjtools-analysis
Command: npx skills add https://github.com/ya-way/cytoclaw-skills --skill bio-tcr-bcr-analysis-vdjtools-analysis

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Immune repertoire analysis often requires combining diversity metrics, clonotype overlap, and clonal-tracking insights across samples. This skill centralizes those tasks around VDJtools to enable reproducible comparisons and visualizations.

Core Features & Use Cases

  • Compute diversity metrics (Shannon, Simpson, Chao1), sample overlap, spectratype, and V/J segment usage for immune repertoires.
  • Track clonotypes over time and identify public or shared clonotypes across samples or conditions.
  • Use with multi-sample metadata to compare groups and visualize clonal dynamics.

Quick Start

Upload MiXCR/VDJtools-compatible input and run the workflow to produce diversity metrics, overlap, spectratype, and clonal-tracking outputs.

Frequently Asked Questions about bio-tcr-bcr-analysis-vdjtools-analysis

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I compute immune repertoire diversity metrics like Shannon and Chao1 from TCR data?

To compute immune repertoire diversity metrics like Shannon and Chao1 from TCR data, upload MiXCR or VDJtools-compatible input files. The workflow processes your samples to calculate diversity indices, sample overlap, and spectratype outputs.

How do I track clonotypes over time across longitudinal multi-sample studies?

You can track clonotypes over time across longitudinal multi-sample studies by processing your VDJtools-compatible files with metadata. This identifies shared or public clonotypes and visualizes clonal dynamics across different conditions and time points.

Can I analyze V and J segment usage and spectratypes for BCR repertoires?

Yes, you can analyze V and J segment usage and spectratypes for BCR repertoires. The workflow processes BCR data alongside TCR data to generate segment-usage outputs and spectratype distributions for comprehensive immune repertoire comparisons.

What input format do I need to compare immune repertoire overlap across multiple conditions?

To compare immune repertoire overlap across multiple conditions, you need MiXCR or VDJtools-compatible input files and a metadata file. Java is also required to run the VDJtools environment for processing the multi-sample comparisons.

How do I parse VDJtools outputs for downstream plotting in Python?

To parse VDJtools outputs for downstream plotting in Python, the workflow provides Python parsing scripts. These scripts process the diversity, overlap, and spectratype outputs to enable custom visualizations of your immune repertoire data.

What is the best way to compare clonal expansion between different sample groups?

The best way to compare clonal expansion between different sample groups is using a multi-sample metadata file with your VDJtools-compatible inputs. This enables reproducible comparisons of clonal dynamics, diversity, and overlap across defined conditions.