Tcr pipeline

Skill BioTender-max/awesome-bio-agent-skills/skills/bioskills/tcr-pipeline

End-to-end TCR/BCR repertoire analysis from FASTQ to clonotype diversity metrics. Use when analyzing immune repertoire sequencing data from bulk or single-cell experiments.From its SKILL.md

Install

npx -y skills add BioTender-max/awesome-bio-agent-skills --skill tcr-pipeline

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

no licenseNo license file was found in the repository. Code published without one is not open source by default, so using it at work is a question for whoever answers licensing questions where you are.

SKILL.md

2.1 KB, 510 tokens by cl100k_base, as published. Nobody here has run it

Version Compatibility

Reference examples tested with: MiXCR 4.6+, VDJtools 1.2.1+

Before using code patterns, verify installed versions match. If versions differ:

CLI: <tool> --version then <tool> --help to confirm flags

If code throws ImportError, AttributeError, or TypeError, introspect the installed package and adapt the example to match the actual API rather than retrying.

TCR/BCR Analysis Pipeline

"Analyze my TCR/BCR repertoire sequencing data end-to-end" → Orchestrate MiXCR clonotype extraction, VDJtools diversity/repertoire analysis, Immcantation SHM and lineage analysis, and visualization of V/J gene usage and clonal dynamics.

Pipeline Overview

FASTQ → MiXCR align → Assemble → Export → VDJtools diversity → Visualization

Step 1: MiXCR Processing

# Align reads to V(D)J segments
mixcr align -s hsa -p rna-seq \
    R1.fastq.gz R2.fastq.gz \
    aligned.vdjca

# Assemble clonotypes
mixcr assemble aligned.vdjca clones.clns

# Export
mixcr exportClones clones.clns clones.txt

Step 2: VDJtools Analysis

# Convert to VDJtools format
vdjtools Convert -S mixcr clones.txt vdjtools/

# Diversity metrics
vdjtools CalcDiversityStats vdjtools/clones.txt diversity/

# Sample overlap
vdjtools CalcPairwiseDistances vdjtools/*.txt overlap/

Step 3: Visualization

# Spectratype plot
vdjtools PlotFancySpectratype vdjtools/clones.txt spectra/

# V usage
vdjtools PlotFancyVJUsage vdjtools/clones.txt usage/

QC Checkpoints

After alignment: Check V/J assignment rate (>70% typical)
After assembly: Verify clonotype count and coverage
After diversity: Compare metrics to expected range

Related Skills

tcr-bcr-analysis/mixcr-analysis - Detailed MiXCR usage
tcr-bcr-analysis/vdjtools-analysis - Diversity metrics
tcr-bcr-analysis/repertoire-visualization - Plots

What ships with it: 2 files

3.3 KB alongside SKILL.md, 1 of them executable

examples/

tcr_full_pipeline.shruns2.1 KB

usage-guide.md1.2 KB