freedomintelligence/openclaw-medical-skills/tcr-pmhc-prediction-agent

Claude Code and agent skill by freedomintelligence/openclaw-medical-skills

Trust tier 3
  • community
Source check pending

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

AI-powered TCR-peptide-MHC interaction prediction using AlphaFold3 and deep learning for therapeutic TCR discovery, neoantigen validation, and T cell immunogenicity assessment.

Install

npx vskill@latest install freedomintelligence/openclaw-medical-skills/tcr-pmhc-prediction-agent

SKILL.md

TCR-pMHC Prediction Agent

The TCR-pMHC Prediction Agent predicts T-cell receptor interactions with peptide-MHC complexes using AlphaFold3-based structural modeling and deep learning. Accurate TCR-pMHC prediction enables therapeutic TCR discovery, neoantigen vaccine validation, and identification of immunogenic epitopes for cancer and infectious disease applications.

When to Use This Skill

  • When predicting which peptides a TCR will recognize.
  • For validating neoantigen immunogenicity computationally.
  • To screen therapeutic TCR candidates against target antigens.
  • When assessing cross-reactivity of TCRs with self-peptides.
  • For understanding TCR specificity determinants.

Core Capabilities

  1. Binding Prediction: Predict TCR-pMHC binding affinity/probability.
  1. Structural Modeling: Generate TCR-pMHC complex structures with AlphaFold3.
  1. Epitope Specificity: Determine which epitopes a TCR recognizes.
  1. Cross-Reactivity Assessment: Predict off-target self-peptide binding.
  1. Immunogenicity Scoring: Rank peptide immunogenicity.
  1. Therapeutic TCR Screening: Screen TCRs for desired specificity.

Prediction Approaches

ApproachMethodStrengths
AlphaFold3Structure predictionHigh accuracy, interpretable
TCR-BERTSequence transformerFast, large-scale
ERGO-IIRNN-basedEstablished benchmark
pMTnetMulti-task learningGeneralizable
NetTCRCNN-basedHLA-specific
TITANAttention-basedState-of-art sequence

Workflow

  1. Input: TCR sequence (alpha/beta CDR3), peptide, HLA allele.
  1. Structure Prediction: Generate pMHC and TCR structures.
  1. Docking: Model TCR-pMHC complex.
  1. Scoring: Calculate binding probability/affinity.
  1. Cross-Reactivity: Screen against self-peptide database.
  1. Validation Features: Extract structural determinants.
  1. Output: Binding predictions, structures, safety assessment.

Example Usage

User: "Predict whether this tumor-reactive TCR binds the identified neoantigen and check for cross-reactivity with self-peptides."

Agent Action:

bash
python3 Skills/Immunology_Vaccines/TCR_pMHC_Prediction_Agent/tcr_pmhc_predict.py \
--tcr_alpha_cdr3 CAVSDRGSTLGRLYF \
--tcr_beta_cdr3 CASSLGQAYEQYF \
--tcr_v_genes TRAV12-1,TRBV7-9 \
--peptide KRAS_G12D_VVGADGVGK \
--hla HLA-A*11:01 \
--check_cross_reactivity true \
--self_peptide_db human_proteome_9mers.fasta \
--method alphafold3 \
--output tcr_pmhc_results/

Input Requirements

InputFormatRequired
TCR CDR3 alphaAmino acid sequenceYes
TCR CDR3 betaAmino acid sequenceYes
V gene usageIMGT notationRecommended
Peptide8-11mer amino acidsYes
HLA allele4-digit resolutionYes

Output Components

OutputDescriptionFormat
Binding ScoreProbability of binding.json
Complex StructureTCR-pMHC model.pdb
Contact MapResidue interactions.csv, .png
Cross-ReactivitySelf-peptide hits.csv
Confidence ScorePrediction reliability.json
Binding DeterminantsKey residues.csv

AlphaFold3 Integration

ComponentApplicationOutput
pMHC ModelingPeptide-MHC structureComplex structure
TCR ModelingVariable region structureTCR structure
Complex PredictionFull ternary complexDocked model
pLDDT ScoresConfidence per residueQuality metric
PAEPositional errorInterface confidence

Binding Prediction Thresholds

Score RangeInterpretationAction
>0.9Strong predicted binderHigh confidence
0.7-0.9Moderate predicted binderLikely positive
0.5-0.7Weak/uncertainExperimental validation needed
<0.5Predicted non-binderLow priority

AI/ML Components

Structural Prediction:

  • AlphaFold3 for complex modeling
  • Molecular dynamics refinement
  • Interface scoring functions

Sequence Models:

  • TCR-specific language models
  • Cross-attention for TCR-peptide
  • Transfer learning from pMHC binding

Cross-Reactivity:

  • Embedding similarity search
  • Structural hotspot analysis
  • Self-tolerance modeling

Performance Benchmarks

MethodDatasetAUCNotes
AlphaFold3VDJdb benchmark0.85Structural
TCR-BERTIEDB0.82Fast screening
ERGO-IIMcPAS-TCR0.78Established
EnsembleCombined0.88Best overall

Clinical Applications

ApplicationUse CaseTCR-pMHC Role
Neoantigen VaccinesValidate immunogenicityPredict T cell response
TCR-T TherapySelect therapeutic TCRsScreen candidates
Safety AssessmentCheck cross-reactivityAvoid autoimmunity
Epitope DiscoveryFind immunogenic peptidesPrioritize targets

Prerequisites

  • Python 3.10+
  • AlphaFold3 installation
  • PyTorch, transformers
  • BioPython, MDAnalysis
  • GPU with 16GB+ VRAM
  • Self-peptide reference database

Related Skills

  • TCR_Repertoire_Analysis_Agent - Repertoire analysis
  • Neoantigen_Prediction_Agent - Neoantigen identification
  • HLA_Typing_Agent - HLA determination
  • CART_Design_Optimizer_Agent - TCR-based therapy

Cross-Reactivity Safety Analysis

DatabaseContentPurpose
Human ProteomeAll self-peptidesPrimary safety
Tissue-SpecificExpression-weightedToxicity prediction
Viral MimicryViral homologsInfection mimics
Cancer-TestisCT antigensOn-target activity

Structural Determinants

FeatureLocationSignificance
CDR3 beta apexPeptide contactSpecificity
CDR3 alphaMHC/peptideFine-tuning
CDR1/2MHC helicesHLA restriction
Germline-encodedFrameworkBase recognition

Special Considerations

  1. HLA Restriction: Predictions are HLA-specific
  2. CDR3 Dominance: CDR3 beta often most predictive
  3. Paired Chains: Alpha-beta pairing crucial
  4. Structural Validation: Validate with known structures
  5. Experimental Follow-up: Tetramer/functional validation

Limitations

LimitationImpactMitigation
Training Data BiasCommon HLA over-representedUse diverse training
Novel TCRsOut-of-distributionLower confidence
Post-translationalPTM peptides not modeledExperimental validation
DynamicsStatic structuresMD simulation

Author

AI Group - Biomedical AI Platform

<!-- AUTHOR_SIGNATURE: 9a7f3c2e-MD-BABU-MIA-2026-MSSM-SECURE -->

Security

  • Security scanPassed, 95 of 100Pattern checks on the skill's files.
  • Model reviewPassed

Quality evaluation

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

Source

Popularity

Repository stars
3,010
Repository forks
410
7-day trend score
40

Stars and forks are for the whole GitHub repository, not this skill alone. Refreshed 16 Sep 2026, a month ago.

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/freedomintelligence/openclaw-medical-skills/tcr-pmhc-prediction-agent/badge)](https://verified-skill.com/skills/freedomintelligence/openclaw-medical-skills/tcr-pmhc-prediction-agent)

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