mims-harvard/tooluniverse

tooluniverse-protein-therapeutic-design

AI-guided de novo protein design — RFdiffusion backbone generation, ProteinMPNN sequence design, structure validation (pLDDT, pTM, MPNN scores).

First seen Feb 7, 2026

Installation

$ npx skills add mims-harvard/tooluniverse --skill tooluniverse-protein-therapeutic-design

Summary

  • AI-guided de novo protein design — RFdiffusion backbone generation, ProteinMPNN sequence design, structure validation (pLDDT, pTM, MPNN scores).
  • Use for designing therapeutic protein binders, novel scaffolds, enzyme variants, and miniprotein/protein-interface design before experimental validation.

Similar popular skills

Related neighbors and high-traction skills in the same topics — useful to compare before installing.

Also in this package

Other skills from mims-harvard/tooluniverse · top by installs.

npx skills add mims-harvard/tooluniverse

Browse all from mims-harvard/tooluniverse

More details

Agent compatibility

Declared targets from SKILL.md / docs. Unmarked agents are not listed — the skill may still install via the CLI.

Claude Code Not declared
Cursor Not declared
Codex Not declared
GitHub Copilot Not declared
Windsurf Not declared
Gemini CLI Not declared
Cline Not declared
OpenCode Not declared

Repository health

Stars 1.7K
License LICENSE
Default branch main
Open issues 9
Status Active

Package contents

Files included with this skill beyond the listing page.

  • skill md SKILL.md 6,323 B
  • docs SUMMARY.md 344 B

History

  1. First seen on skills.sh
  2. First recorded snapshot · 383 installs

SKILL.md

Therapeutic Protein Designer

AI-guided de novo protein design using RFdiffusion backbone generation, ProteinMPNN sequence optimization, and structure validation for therapeutic protein development.

KEY PRINCIPLES:

  1. Structure-first - Generate backbone geometry before sequence
  2. Target-guided - Design binders with target structure in mind
  3. Iterative validation - Predict structure to validate designs
  4. Developability-aware - Consider aggregation, immunogenicity, expression
  5. Evidence-graded - Grade designs by confidence metrics
  6. Actionable output - Provide sequences ready for experimental testing
  7. English-first queries - Always use English terms in tool calls

Therapeutic protein design starts with the target interaction. What binding surface do you need to cover? A small pocket = nanobody or peptide. A large flat surface = designed protein. Stability, immunogenicity, and manufacturability constrain the design space.

LOOK UP, DON'T GUESS

When uncertain about any scientific fact, SEARCH databases first rather than reasoning from memory. A database-verified answer is always more reliable than a guess.


COMPUTE, DON'T DESCRIBE

When analysis requires computation (statistics, data processing, scoring, enrichment), write and run Python code via Bash. Don't describe what you would do — execute it and report actual results. Use ToolUniverse tools to retrieve data, then Python (pandas, scipy, statsmodels, matplotlib) to analyze it.

When to Use

Apply when user asks to:

  • Design a protein binder, therapeutic protein, or scaffold
  • Optimize a protein sequence for function
  • Design a de novo enzyme
  • Generate protein variants for target binding

Workflow Overview

Phase 1: Target Characterization
  Get structure (PDB, EMDB cryo-EM, AlphaFold), identify binding epitope

Phase 2: Backbone Generation (RFdiffusion)
  Define constraints, generate >= 5 backbones, filter by geometry

Phase 3: Sequence Design (ProteinMPNN)
  Design >= 8 sequences per backbone, sample with temperature control

Phase 4: Structure Validation (ESMFold/AlphaFold2)
  Predict structure, compare to backbone, assess pLDDT/pTM

Phase 5: Developability Assessment
  Aggregation, pI, expression prediction

Phase 6: Report Synthesis
  Ranked candidates, FASTA, experimental recommendations

Critical Requirements

Report-First Approach (MANDATORY)

  1. Create [TARGET]proteindesign_report.md first with section headers
  2. Progressively update as designs are generated
  3. Output [TARGET]designedsequences.fasta and [TARGET]topcandidates.csv

Design Documentation (MANDATORY)

Every design MUST include: Sequence, Length, Target, Method, and Quality Metrics (pLDDT, pTM, MPNN score, binding prediction).


NVIDIA NIM Tools

Tool Purpose Key Parameter
NvidiaNIMrfdiffusion (requires NVIDIAAPI_KEY env var; free key at build.nvidia.com) Backbone generation diffusionsteps (NOT numsteps)
NvidiaNIMproteinmpnn (requires NVIDIAAPI_KEY env var; free key at build.nvidia.com) Sequence design pdb_string (NOT pdb)
ESMFoldpredictstructure Fast validation sequence (NOT seq)
NvidiaNIMalphafold2 (requires NVIDIAAPI_KEY env var; free key at build.nvidia.com) High-accuracy structure inference from sequence sequence, algorithm
NvidiaNIMesm2650m (requires NVIDIAAPIKEY env var; free key at build.nvidia.com) Sequence embeddings sequences, format

Common Parameter Mistakes

Tool Wrong Correct
NvidiaNIMrfdiffusion (requires NVIDIAAPI_KEY) num_steps=50 diffusion_steps=50
NvidiaNIMproteinmpnn (requires NVIDIAAPI_KEY) pdb=content pdb_string=content
ESMFoldpredictstructure seq="MVLS..." sequence="MVLS..."
NvidiaNIMalphafold2 (requires NVIDIAAPI_KEY) seq="MVLS..." sequence="MVLS..."

NVIDIA NIM Requirements

  • API Key: NVIDIAAPIKEY environment variable required
  • Rate limits: 40 RPM (1.5 second minimum between calls)
  • AlphaFold2 may return 202 (polling required); RFdiffusion and ESMFold are synchronous

Supporting Tools

Tool Purpose Key Parameters
PDBegetuniprot_mappings Find PDB structures uniprot_id
RCSBDatagetentry Download PDB file pdb_id
alphafoldgetprediction Get AlphaFold DB structure accession
EMDBsearchstructures Search cryo-EM maps query
EMDBgetstructure Get entry details entry_id
UniProtgetentrybyaccession Get target sequence accession
InterProgetprotein_domains Get domains accession

Evidence Grading

Tier Criteria
T1 (best) pLDDT >85, pTM >0.8, low aggregation, neutral pI
T2 pLDDT >75, pTM >0.7, acceptable developability
T3 pLDDT >70, pTM >0.65, developability concerns
T4 Failed validation or major developability issues

Completeness Checklist

  • Target structure obtained (PDB or predicted)
  • Binding epitope identified
  • >= 5 backbones generated, top 3-5 selected
  • >= 8 sequences per backbone, MPNN scores reported
  • All sequences validated (ESMFold), pLDDT/pTM reported, >= 3 passing
  • Developability assessed (aggregation, pI, expression)
  • Ranked candidate list, FASTA file, experimental recommendations

Reference Files

  • DESIGN_PROCEDURES.md - Phase-by-phase code examples, sampling parameters, fallback chains
  • TOOLS_REFERENCE.md - Complete tool documentation with code examples
  • EXAMPLES.md - Sample design workflows and outputs
  • CHECKLIST.md - Detailed phase checklists and quality metrics
  • design_templates.md - Report templates and output format examples