freedomintelligence/openclaw-medical-skills/tcr-pmhc-prediction-agent
Claude Code and agent skill by freedomintelligence/openclaw-medical-skills
- community
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-agentSKILL.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
- Binding Prediction: Predict TCR-pMHC binding affinity/probability.
- Structural Modeling: Generate TCR-pMHC complex structures with AlphaFold3.
- Epitope Specificity: Determine which epitopes a TCR recognizes.
- Cross-Reactivity Assessment: Predict off-target self-peptide binding.
- Immunogenicity Scoring: Rank peptide immunogenicity.
- Therapeutic TCR Screening: Screen TCRs for desired specificity.
Prediction Approaches
| Approach | Method | Strengths | |
|---|---|---|---|
| AlphaFold3 | Structure prediction | High accuracy, interpretable | |
| TCR-BERT | Sequence transformer | Fast, large-scale | |
| ERGO-II | RNN-based | Established benchmark | |
| pMTnet | Multi-task learning | Generalizable | |
| NetTCR | CNN-based | HLA-specific | |
| TITAN | Attention-based | State-of-art sequence |
Workflow
- Input: TCR sequence (alpha/beta CDR3), peptide, HLA allele.
- Structure Prediction: Generate pMHC and TCR structures.
- Docking: Model TCR-pMHC complex.
- Scoring: Calculate binding probability/affinity.
- Cross-Reactivity: Screen against self-peptide database.
- Validation Features: Extract structural determinants.
- 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:
Input Requirements
| Input | Format | Required | |
|---|---|---|---|
| TCR CDR3 alpha | Amino acid sequence | Yes | |
| TCR CDR3 beta | Amino acid sequence | Yes | |
| V gene usage | IMGT notation | Recommended | |
| Peptide | 8-11mer amino acids | Yes | |
| HLA allele | 4-digit resolution | Yes |
Output Components
| Output | Description | Format | |
|---|---|---|---|
| Binding Score | Probability of binding | .json | |
| Complex Structure | TCR-pMHC model | .pdb | |
| Contact Map | Residue interactions | .csv, .png | |
| Cross-Reactivity | Self-peptide hits | .csv | |
| Confidence Score | Prediction reliability | .json | |
| Binding Determinants | Key residues | .csv |
AlphaFold3 Integration
| Component | Application | Output | |
|---|---|---|---|
| pMHC Modeling | Peptide-MHC structure | Complex structure | |
| TCR Modeling | Variable region structure | TCR structure | |
| Complex Prediction | Full ternary complex | Docked model | |
| pLDDT Scores | Confidence per residue | Quality metric | |
| PAE | Positional error | Interface confidence |
Binding Prediction Thresholds
| Score Range | Interpretation | Action | |
|---|---|---|---|
| >0.9 | Strong predicted binder | High confidence | |
| 0.7-0.9 | Moderate predicted binder | Likely positive | |
| 0.5-0.7 | Weak/uncertain | Experimental validation needed | |
| <0.5 | Predicted non-binder | Low 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
| Method | Dataset | AUC | Notes | |
|---|---|---|---|---|
| AlphaFold3 | VDJdb benchmark | 0.85 | Structural | |
| TCR-BERT | IEDB | 0.82 | Fast screening | |
| ERGO-II | McPAS-TCR | 0.78 | Established | |
| Ensemble | Combined | 0.88 | Best overall |
Clinical Applications
| Application | Use Case | TCR-pMHC Role | |
|---|---|---|---|
| Neoantigen Vaccines | Validate immunogenicity | Predict T cell response | |
| TCR-T Therapy | Select therapeutic TCRs | Screen candidates | |
| Safety Assessment | Check cross-reactivity | Avoid autoimmunity | |
| Epitope Discovery | Find immunogenic peptides | Prioritize 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
| Database | Content | Purpose | |
|---|---|---|---|
| Human Proteome | All self-peptides | Primary safety | |
| Tissue-Specific | Expression-weighted | Toxicity prediction | |
| Viral Mimicry | Viral homologs | Infection mimics | |
| Cancer-Testis | CT antigens | On-target activity |
Structural Determinants
| Feature | Location | Significance | |
|---|---|---|---|
| CDR3 beta apex | Peptide contact | Specificity | |
| CDR3 alpha | MHC/peptide | Fine-tuning | |
| CDR1/2 | MHC helices | HLA restriction | |
| Germline-encoded | Framework | Base recognition |
Special Considerations
- HLA Restriction: Predictions are HLA-specific
- CDR3 Dominance: CDR3 beta often most predictive
- Paired Chains: Alpha-beta pairing crucial
- Structural Validation: Validate with known structures
- Experimental Follow-up: Tetramer/functional validation
Limitations
| Limitation | Impact | Mitigation | |
|---|---|---|---|
| Training Data Bias | Common HLA over-represented | Use diverse training | |
| Novel TCRs | Out-of-distribution | Lower confidence | |
| Post-translational | PTM peptides not modeled | Experimental validation | |
| Dynamics | Static structures | MD 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
- SKILL.md in the repositoryCheckingskills/tcr-pmhc-prediction-agent/SKILL.md
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
[](https://verified-skill.com/skills/freedomintelligence/openclaw-medical-skills/tcr-pmhc-prediction-agent)