tooluniverse-antibody-engineering▌
mims-harvard/tooluniverse · updated Apr 8, 2026
MDX-style export adds YAML metadata + attribution linking explainx.ai and this canonical listing URL.
AI-guided antibody optimization pipeline from preclinical lead to clinical candidate. Covers sequence humanization, structure modeling, affinity optimization, developability assessment, immunogenicity prediction, and manufacturing feasibility.
Antibody Engineering & Optimization
AI-guided antibody optimization pipeline from preclinical lead to clinical candidate. Covers sequence humanization, structure modeling, affinity optimization, developability assessment, immunogenicity prediction, and manufacturing feasibility.
KEY PRINCIPLES:
- Report-first approach - Create optimization report before analysis
- Evidence-graded humanization - Score based on germline alignment and framework retention
- Developability-focused - Assess aggregation, stability, PTMs, immunogenicity
- Structure-guided - Use AlphaFold/PDB structures for CDR analysis
- Clinical precedent - Reference approved antibodies for validation
- Quantitative scoring - Developability score (0-100) combining multiple factors
- English-first queries - Always use English terms in tool calls, even if user writes in another language. Respond in user's language
LOOK UP, DON'T GUESS
When uncertain about any scientific fact, SEARCH databases first (PubMed, UniProt, ChEMBL, ClinVar, etc.) rather than reasoning from memory. A database-verified answer is always more reliable than a guess.
When to Use
Apply when user asks:
- "Humanize this mouse antibody sequence"
- "Optimize antibody affinity for [target]"
- "Assess developability of this antibody"
- "Predict immunogenicity risk for [sequence]"
- "Engineer bispecific antibody against [targets]"
- "Reduce aggregation in antibody formulation"
- "Design pH-dependent binding antibody"
- "Analyze CDR sequences and suggest mutations"
Critical Workflow Requirements
1. Report-First Approach (MANDATORY)
- Create the report file FIRST:
antibody_optimization_report.md - Progressively update as analysis completes
- Output separate files:
optimized_sequences.fasta- All optimized variantshumanization_comparison.csv- Before/after comparisondevelopability_assessment.csv- Detailed scores
See REPORT_TEMPLATE.md for the full report template with section formats.
2. Documentation Standards (MANDATORY)
Every optimization MUST include per-variant documentation with:
- Original and optimized sequences
- Humanization score (% human framework)
- CDR preservation confirmation
- Metrics table (humanness, aggregation risk, predicted KD, immunogenicity)
- Data source citations
Phase 0: Tool Verification
Required Tools
| Tool | Purpose | Category |
|---|---|---|
IMGT_search_genes |
Germline gene identification | Humanization |
IMGT_get_sequence |
Human framework sequences | Humanization |
SAbDab_search_structures |
Antibody structure precedents | Structure |
TheraSAbDab_search_by_target |
Clinical antibody benchmarks | Validation |
alphafold_get_prediction |
Structure modeling | Structure |
iedb_search_epitopes |
Epitope identification | Immunogenicity |
iedb_search_bcell |
B-cell epitope prediction | Immunogenicity |
UniProt_get_entry_by_accession |
Target antigen information | Target |
STRING_get_interaction_partners |
Protein interaction network | Bispecifics |
PubMed_search_articles |
Literature precedents | Validation |
CRITICAL: SOAP tools (IMGT, SAbDab, TheraSAbDab) require an operation parameter. See QUICK_START.md for correct usage.
Workflow Overview
Phase 1: Input Analysis & Characterization
├── Sequence annotation (CDRs, framework)
├── Species identification
├── Target antigen identification
├── Clinical precedent search
└── OUTPUT: Input characterization
↓
Phase 2: Humanization Strategy
├── Germline gene alignment (IMGT)
├── Framework selection
├── CDR grafting design
├── Backmutation identification
└── OUTPUT: Humanization plan
↓
Phase 3: Structure Modeling & Analysis
├── AlphaFold prediction
├── CDR conformation analysis
├── Epitope mapping
├── Interface analysis
└── OUTPUT: Structural assessment
↓
Phase 4: Affinity Optimization
├── In silico mutation screening
├── CDR optimization strategies
├── Interface improvement
└── OUTPUT: Affinity variants
↓
Phase 5: Developability Assessment
├── Aggregation propensity
├── PTM site identification
├── Stability prediction
├── Expression prediction
└── OUTPUT: Developability score
↓
Phase 6: Immunogenicity Prediction
├── MHC-II epitope prediction (IEDB)
├── T-cell epitope risk
├── Aggregation-related immunogenicity
└── OUTPUT: Immunogenicity risk score
↓
Phase 7: Manufacturing Feasibility
├── Expression level prediction
├── Purification considerations
├── Formulation stability
└── OUTPUT: Manufacturing assessment
↓
Phase 8: Final Report & Recommendations
├── Ranked variant list
├── Experimental validation plan
├── Next steps
└── OUTPUT: Comprehensive report
Phase 1: Input Analysis & Characterization
Goal: Annotate sequences, identify species/germline, find clinical precedents.
Key steps:
- Annotate CDRs using IMGT numbering (CDR-H1: 27-38, CDR-H2: 56-65, CDR-H3: 105-117)
- Identify closest human germline genes via
IMGT_search_genes - Search clinical precedents via
TheraSAbDab_search_by_target - Get target antigen info via
UniProt_get_entry_by_accession
Output: Sequence information table, CDR annotation, target info, clinical precedent list.
See WORKFLOW_DETAILS.md Phase 1 for code examples.
Phase 2: Humanization Strategy
Goal: Select human framework, design CDR grafting, identify backmutations.
Key steps:
- Search IMGT for IGHV/IGKV human germline genes
- Score candidate frameworks by identity, CDR compatibility, and clinical use
- Design CDR grafting onto selected framework
- Identify Vernier zone residues that may need backmutation (positions 2, 27-30, 47-48, 67, 69, 71, 78, 93-94)
- Generate at least 2 variants: full humanization and with key backmutations
- Calculate humanization score (framework humanness, CDR preservation, T-cell epitopes, aggregation risk)
Output: Framework selection rationale, grafting design, backmutation analysis, humanized sequences.
See WORKFLOW_DETAILS.md Phase 2 for code examples.
Phase 3: Structure Modeling & Analysis
Goal: Predict structure, analyze CDR conformations, map epitope.
Key steps:
- Predict Fv structure via
alphafold_get_prediction(VH:VL) - Assess pLDDT scores by region (framework, CDRs, interface)
- Classify CDR canonical structures and calculate RMSD
- Search known epitopes via
iedb_search_epitopes - Compare with clinical antibody structures via
SAbDab_search_structures
Output: Structure quality table, CDR conformation analysis, epitope mapping, structural comparison.
See WORKFLOW_DETAILS.md Phase 3 for code examples.
Phase 4: Affinity Optimization
Goal: Design affinity-improving mutations via computational screening.
Key steps:
- Identify interface residues (distance cutoff 4.5 A)
- Screen all amino acid substitutions at CDR interface positions
- Rank by predicted binding energy change (ddG < -0.5 kcal/mol = favorable)
- Design combination strategy: single -> double -> triple mutants
- Consider CDR-H3 extension, tyrosine enrichment, salt bridge formation
- Optional: pH-dependent binding via histidine substitutions
Output: Ranked mutation list, combination strategy, expected affinity improvements.
See WORKFLOW_DETAILS.md Phase 4 for code examples.
Phase 5: Developability Assessment
Goal: Comprehensive developability scoring (0-100) across five dimensions.
Key steps:
- Aggregation: Find aggregation-prone regions, calculate TANGO/AGGRESCAN scores, assess pI
- PTM liability: Scan for deamidation (NG/NS), isomerization (DG/DS), oxidation (Met/Trp), N-glycosylation (N-X-S/T)
- Stability: Predict thermal stability (Tm target >70C, Tonset >65C)
- Expression: Predict CHO titer and soluble fraction
- Solubility: Predict maximum formulation concentration
Scoring: Weighted average (aggregation 0.30, PTM 0.25, stability 0.20, expression 0.15, solubility 0.10). Tiers: T1 (>75), T2 (60-75), T3 (<60).
Output: Component scores, overall score, tier classification, mitigation recommendations.
See WORKFLOW_DETAILS.md Phase 5 and CHECKLISTS.md for scoring details.
Phase 6: Immunogenicity Prediction
Goal: Predict immunogenicity risk and design deimmunization strategy.
Key steps:
- Scan 9-mer peptides against IEDB for MHC-II binding epitopes
- Count non-human residues in framework regions
- Assess aggregation-related immunogenicity
- Calculate total risk score (0-100, lower is better): Low <30, Medium 30-60, High >60
- Propose deimmunization mutations (remove T-cell epitopes while preserving CDRs)
- Compare with clinical precedent ADA rates
Output: T-cell epitope list, risk score breakdown, deimmunization strategy, clinical comparison.
See WORKFLOW_DETAILS.md Phase 6 for code examples.
Phase 7: Manufacturing Feasibility
Goal: Assess expression, purification, formulation, and CMC feasibility.
Key steps:
- Assess codon optimization for CHO, identify rare codons
- Design signal peptide
- Plan 3-step purification: Protein A capture -> cation exchange polishing -> viral nanofiltration
- Recommend formulation (buffer, pH, stabilizer, tonicity)
- Define analytical characterization panel (SEC-MALS, CEX, CE-SDS, SPR, DSF)
- Estimate CMC timeline and costs (typically 18-24 months, $1.65-2.65M to IND)
Output: Expression assessment, purification strategy, formulation recommendation, CMC timeline.
See MANUFACTURING.md for detailed manufacturing content and WORKFLOW_DETAILS.md Phase 7 for code.
Phase 8: Final Report & Recommendations
Goal: Compile all findings into a ranked recommendation with validation plan.
Key outputs:
- Top candidate with key metrics (humanness, affinity, developability, immunogenicity, stability, expression)
- Key improvements table comparing original vs. optimized
- Experimental validation plan: In vitro (3-4 months) -> Lead optimization (2-3 months) -> Preclinical (6-12 months)
- Backup variants with profiles and recommendations
- IP considerations: FTO analysis, CDR novelty, patentability
- Next steps: Immediate (month 1-3), short-term (4-6), long-term (7-24)
See REPORT_TEMPLATE.md for the full report template.
Tool Reference
IMGT Tools
IMGT_search_genes: Search germline genes (IGHV, IGKV, etc.)IMGT_get_sequence: Get germline sequencesIMGT_get_gene_info: Database information
Antibody Databases
SAbDab_search_structures: Search antibody structuresSAbDab_get_structure: Get structure detailsTheraSAbDab_search_therapeutics: Search by nameTheraSAbDab_search_by_target: Search by target antigen
Immunogenicity
iedb_search_epitopes: Search epitopesiedb_search_bcell: B-cell epitopesiedb_search_mhc: MHC-II epitopesiedb_get_epitope_references: Citations
Structure & Target
alphafold_get_prediction: Structure predictionUniProt_get_entry_by_accession: Target infoRCSBData_get_entry: Experimental structures
Systems Biology (for Bispecifics)
STRING_get_interaction_partners: Protein interactionsSTRING_get_enrichment: Pathway analysis
Reference Files
| File | Contents |
|---|---|
QUICK_START.md |
Getting started guide, SOAP tool parameters, Python SDK and MCP usage |
WORKFLOW_DETAILS.md |
Code examples for all 8 phases |
REPORT_TEMPLATE.md |
Full report template with section formats and example tables |
MANUFACTURING.md |
Detailed manufacturing content (expression, purification, formulation, CMC) |
EXAMPLES.md |
Complete clinical scenario examples (humanization, affinity, bispecific) |
CHECKLISTS.md |
Evidence grading, completeness checklists, scoring details, special considerations |
How to use tooluniverse-antibody-engineering on Cursor
AI-first code editor with Composer
Prerequisites
Before installing skills in Cursor, ensure your development environment meets these requirements:
- ›Cursor installed and configured on your development machine
- ›Node.js version 16.0+ with npm package manager (verify with
node --version) - ›Active project directory or workspace where you want to add tooluniverse-antibody-engineering
Execute installation command
Execute the skills CLI command in your project's root directory to begin installation:
The skills CLI fetches tooluniverse-antibody-engineering from GitHub repository mims-harvard/tooluniverse and configures it for Cursor.
Select Cursor when prompted
The CLI will show a list of available agents. Use arrow keys to navigate and space to select Cursor:
Verify installation
Confirm successful installation by checking the skill directory location:
Reload or restart Cursor to activate tooluniverse-antibody-engineering. Access the skill through slash commands (e.g., /tooluniverse-antibody-engineering) or your agent's skill management interface.
Security & Verification Notice
We perform automated surface-level scans (Gen AI Scanner, Socket, Snyk) during installation. These checks detect common vulnerabilities but do not guarantee complete security. Always review skill source code and verify the publisher's reputation before production use.
Skills execute code in your development environment. Always verify the publisher's identity, review recent commits, and test in isolated environments before production deployment.
List & Monetize Your Skill
Submit your Claude Code skill and start earning
Use Cases▌
User Story & Requirements Generation
Create detailed user stories, acceptance criteria, and feature specs
Example
Generate user stories for 'password reset feature' with acceptance criteria, edge cases, and test scenarios
Reduce spec writing time by 50%, ensure comprehensive coverage
Competitive Analysis
Research competitors, compare features, identify gaps
Example
Analyze 5 competitor products, create feature comparison matrix, suggest differentiation opportunities
Complete competitive research in 2 hours instead of 2 days
Roadmap Prioritization
Evaluate features using frameworks (RICE, ICE, Kano) and create prioritized backlogs
Example
Score 20 feature ideas using RICE framework, generate prioritized roadmap with rationale
Make data-driven prioritization decisions faster
Stakeholder Communication
Draft PRDs, status updates, and stakeholder presentations
Example
Create executive summary of Q3 roadmap, monthly progress report, feature launch announcement
Save 3-5 hours/week on communication overhead
Implementation Guide▌
Prerequisites
- ›Claude Desktop or compatible AI client
- ›Access to product documentation and roadmap tools (Jira, Notion, etc.)
- ›Understanding of product management frameworks (RICE, Jobs-to-be-Done, etc.)
- ›Stakeholder contact information and communication channels
Time Estimate
30-60 minutes to see productivity improvements
Installation Steps
- 1.Install product management skill
- 2.Start with user story generation for known feature
- 3.Progress to competitive analysis: research 2-3 competitors
- 4.Use for roadmap prioritization: apply RICE/ICE scoring
- 5.Draft stakeholder communications and refine based on feedback
- 6.Build template library for recurring PM tasks
- 7.Share effective prompts with product team
Common Pitfalls
- ⚠Not validating competitive research—verify facts before sharing
- ⚠Accepting user stories without involving engineering team
- ⚠Over-relying on frameworks without qualitative judgment
- ⚠Not customizing outputs to company culture and communication style
- ⚠Skipping stakeholder validation of generated requirements
Best Practices▌
✓ Do
- +Validate research and competitive analysis with real data
- +Collaborate with engineering when generating technical requirements
- +Customize frameworks and templates to your company context
- +Use skill for first drafts, refine with stakeholder input
- +Document successful prompt patterns for PM tasks
- +Combine AI efficiency with human judgment and intuition
✗ Don't
- −Don't publish competitive analysis without fact-checking
- −Don't finalize user stories without engineering review
- −Don't make prioritization decisions solely on AI scoring
- −Don't skip customer validation of generated requirements
- −Don't ignore company-specific context and culture
💡 Pro Tips
- ★Provide context: company goals, constraints, customer feedback
- ★Ask for alternatives: 'Show 3 ways to prioritize this roadmap'
- ★Request stakeholder-specific formatting: 'Executive summary vs. engineering spec'
- ★Use skill for 70% generation + 30% customization to company needs
When to Use This▌
✓ Use When
Use for user story writing, competitive research, roadmap prioritization, stakeholder communication, and PRD drafting. Best for reducing repetitive documentation and research work.
✗ Avoid When
Avoid for strategic product vision (requires deep customer empathy), pricing decisions (needs market and financial expertise), or when face-to-face customer discovery is more valuable than speed.
Learning Path▌
- 1Basic: user stories, feature specs, status updates
- 2Intermediate: competitive analysis, prioritization frameworks, PRDs
- 3Advanced: product strategy, go-to-market planning, OKR setting
- 4Expert: product vision, market positioning, business model innovation
Discussion
Product Hunt–style comments (not star reviews)- No comments yet — start the thread.
Ratings
4.8★★★★★47 reviews- ★★★★★Chaitanya Patil· Dec 24, 2024
tooluniverse-antibody-engineering reduced setup friction for our internal harness; good balance of opinion and flexibility.
- ★★★★★Isabella Gill· Dec 16, 2024
We added tooluniverse-antibody-engineering from the explainx registry; install was straightforward and the SKILL.md answered most questions upfront.
- ★★★★★Michael Okafor· Dec 8, 2024
tooluniverse-antibody-engineering reduced setup friction for our internal harness; good balance of opinion and flexibility.
- ★★★★★Luis Li· Nov 27, 2024
I recommend tooluniverse-antibody-engineering for anyone iterating fast on agent tooling; clear intent and a small, reviewable surface area.
- ★★★★★Piyush G· Nov 15, 2024
I recommend tooluniverse-antibody-engineering for anyone iterating fast on agent tooling; clear intent and a small, reviewable surface area.
- ★★★★★Ren Huang· Nov 7, 2024
Solid pick for teams standardizing on skills: tooluniverse-antibody-engineering is focused, and the summary matches what you get after install.
- ★★★★★Lucas Lopez· Oct 26, 2024
tooluniverse-antibody-engineering has been reliable in day-to-day use. Documentation quality is above average for community skills.
- ★★★★★Evelyn Desai· Oct 18, 2024
Useful defaults in tooluniverse-antibody-engineering — fewer surprises than typical one-off scripts, and it plays nicely with `npx skills` flows.
- ★★★★★Shikha Mishra· Oct 6, 2024
Useful defaults in tooluniverse-antibody-engineering — fewer surprises than typical one-off scripts, and it plays nicely with `npx skills` flows.
- ★★★★★Yash Thakker· Sep 25, 2024
tooluniverse-antibody-engineering has been reliable in day-to-day use. Documentation quality is above average for community skills.
showing 1-10 of 47