Now liveThe Skillselion MCP - thousands of ranked skills, loaded into your agent mid-task. No install.Get it →
gptomics avatar

Bio Workflows Tcr Pipeline

  • 3 installs
  • 1.1k repo stars
  • Updated July 25, 2026
  • gptomics/bioskills

Run an end-to-end TCR/BCR repertoire analysis from FASTQ to clonotype diversity metrics using MiXCR and VDJtools.

About

Orchestrates MiXCR V(D)J alignment, clonotype assembly, and VDJtools diversity metrics for immune repertoire sequencing. A developer uses it to analyze bulk or single-cell TCR/BCR data into clonotype and diversity output.

  • MiXCR align, assemble, and export of V(D)J clonotypes
  • VDJtools diversity metrics and repertoire visualization

Bio Workflows Tcr Pipeline by the numbers

  • 3 all-time installs (skills.sh)
  • Ranked #1,661 of 2,064 Data Science & ML skills by installs in the Skillselion catalog
  • Data as of Aug 5, 2026 (Skillselion catalog sync)
npx skills add https://github.com/gptomics/bioskills --skill bio-workflows-tcr-pipeline

Add your badge

Show developers this skill is listed on Skillselion. Paste this into your README.

Listed on Skillselion
Installs3
repo stars1.1k
Last updatedJuly 25, 2026
Repositorygptomics/bioskills

What it does

Run an end-to-end TCR/BCR repertoire analysis from FASTQ to clonotype diversity metrics using MiXCR and VDJtools.

Files

SKILL.mdMarkdownGitHub ↗

TCR/BCR Analysis Pipeline

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

1. After alignment: Check V/J assignment rate (>70% typical) 2. After assembly: Verify clonotype count and coverage 3. 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

Related skills

Data Science & MLpipelinesanalytics

This week in AI coding

Five minutes, every Monday - the tools, releases and tactics for developers.

unsubscribe anytime.