
tooluniverse-protein-therapeutic-design
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.
- Installs
- 399
- Last 24h
- —
- Trending rank
- —
- Security
- Not audited
Install
Works with every agent the skills CLI supports.
npx skills add https://github.com/mims-harvard/tooluniverse --skill tooluniverse-protein-therapeutic-design- 01
Install
Run the command in your project. The CLI asks which agents to install for.
- 02
Describe the task
Ask your agent for something this skill covers. It loads tooluniverse-protein-therapeutic-design automatically when relevant.
- 03
Review the result
The agent follows the SKILL.md steps, scripts and references bundled with the skill.
SKILL.md
The instructions your agent reads when the skill is triggered.
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:
- Structure-first - Generate backbone geometry before sequence
- Target-guided - Design binders with target structure in mind
- Iterative validation - Predict structure to validate designs
- Developability-aware - Consider aggregation, immunogenicity, expression
- Evidence-separated - Report folding, pose, geometry, protonation and experimental evidence independently
- Actionable output - Provide sequences ready for experimental testing
- 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
For iterative campaigns, conflicting predictions, glycosylated receptor checks, conditional pH binding, or competition preparation, use Protein Design Campaign alongside this workflow. Verify installed tool schemas before executing examples; model confidence and successful execution do not establish binding.
Report-First Approach (MANDATORY)
- Create
[TARGET]_protein_design_report.mdfirst with section headers - Progressively update as designs are generated
- Output
[TARGET]_designed_sequences.fastaand[TARGET]_top_candidates.csv
Design Documentation (MANDATORY)
Every design MUST include: Sequence, Length, Target, Method, and available Quality Metrics (pLDDT, pTM, MPNN score, binding prediction). Mark unavailable metrics unmeasured or uncomputed; do not fabricate binding predictions or experimental values.
NVIDIA NIM Tools
| Tool | Purpose | Key Parameter |
|---|---|---|
NvidiaNIM_rfdiffusion (requires NVIDIA_API_KEY env var; free key at build.nvidia.com) | Backbone generation | contigs + input_pdb (both required), diffusion_steps (NOT num_steps; default 15) |
NvidiaNIM_proteinmpnn (requires NVIDIA_API_KEY env var; free key at build.nvidia.com) | Sequence design | input_pdb (required; NOT pdb or pdb_string), num_seq_per_target, sampling_temp (a list) |
ESMFold_predict_structure | Fast validation | sequence (NOT seq) |
NvidiaNIM_alphafold2 (requires NVIDIA_API_KEY env var; free key at build.nvidia.com) | High-accuracy structure inference from sequence | sequence, algorithm |
NvidiaNIM_esm2_650m (requires NVIDIA_API_KEY env var; free key at build.nvidia.com) | Sequence embeddings | sequences, format |
Common Parameter Mistakes
| Tool | Wrong | Correct |
|---|---|---|
NvidiaNIM_rfdiffusion (requires NVIDIA_API_KEY) | num_steps=50 | diffusion_steps=50 (plus required contigs and input_pdb) |
NvidiaNIM_proteinmpnn (requires NVIDIA_API_KEY) | pdb=content or pdb_string=content | input_pdb=content |
ESMFold_predict_structure | seq="MVLS..." | sequence="MVLS..." |
NvidiaNIM_alphafold2 (requires NVIDIA_API_KEY) | seq="MVLS..." | sequence="MVLS..." |
NVIDIA NIM Requirements
- API Key:
NVIDIA_API_KEYenvironment 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 |
|---|---|---|
PDBe_get_uniprot_mappings | Find PDB structures | uniprot_id |
RCSBData_get_entry | Download PDB file | pdb_id |
alphafold_get_prediction | Get AlphaFold DB structure | accession |
EMDB_search_structures | Search cryo-EM maps | query |
EMDB_get_structure | Get entry details | entry_id |
UniProt_get_entry_by_accession | Get target sequence | accession |
InterPro_get_protein_domains | Get domains | accession |
Folding and Developability Screening
These are illustrative computational screening tiers, not binding-evidence grades or calibrated success probabilities. Benchmark screening with appropriate controls. Monomer pLDDT/pTM cannot establish a complex pose, affinity, cross-species binding or pH selectivity. Report those dimensions separately, including missing evidence.
| Tier | Criteria |
|---|---|
| T1 (strongest in this screen) | 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
FAQ
What does the tooluniverse-protein-therapeutic-design skill do?
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.
How do I install tooluniverse-protein-therapeutic-design?
Run npx skills add https://github.com/mims-harvard/tooluniverse --skill tooluniverse-protein-therapeutic-design in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/tooluniverse-protein-therapeutic-design/ (personal) or .claude/skills/tooluniverse-protein-therapeutic-design/ (project).
Which AI agents can use tooluniverse-protein-therapeutic-design?
Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.
Is tooluniverse-protein-therapeutic-design safe to install?
No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.
Who maintains tooluniverse-protein-therapeutic-design?
It is published by mims-harvard in mims-harvard/tooluniverse. It has 399 recorded installs.
More from mims-harvard/tooluniverse
tooluniverse-sequence-retrieval
mims-harvard/tooluniverse
Retrieve DNA/RNA/protein sequences from NCBI and ENA with disambiguation. Quality hierarchy: RefSeq (NM/NP) RefSeq predicted (XM/XP) GenBank submissions. Use for fetching specific sequences by accession, gene-symbol-to-sequence lookup, transcript-isoform retrieval, and curated-vs-raw-submission preference.
tooluniverse-literature-deep-research
mims-harvard/tooluniverse
Deep literature review — PubMed, EuropePMC, bioRxiv preprints, citation networks, evidence synthesis. Disambiguates queries, runs collision-aware searches, grades evidence T1-T4, and produces structured reports. Use for systematic literature review, meta-analysis evidence collection, and detailed answer-with-citations workflows.
tooluniverse-image-analysis
mims-harvard/tooluniverse
Microscopy and quantitative imaging analysis — colony morphometry, fluorescence intensity quantification, cell-count statistics, dose-response curves, and ANOVA/Dunnett on image-derived measurements. Uses pandas/numpy/scipy/scikit-image. Use for analyzing tabular outputs from CellProfiler/ImageJ, image-derived measurement statistics, and image-based assay quantification.
tooluniverse-clinical-guidelines
mims-harvard/tooluniverse
Search and retrieve clinical practice guidelines from 12+ authoritative sources — NICE, WHO, NCCN, AHA, ADA, SIGN, USPSTF, IDSA, NIH consensus, ESMO/ESC/EASL European societies, and US specialty associations. Use for evidence-graded treatment recommendations, dosing protocols, screening guidance, and authoritative-source-prioritized clinical guidance (NICE/WHO ranked above society guidelines).
tooluniverse
mims-harvard/tooluniverse
ToolUniverse plugin router. STEP 1 BEFORE ANY ANALYSIS: if the data folder contains executed.ipynb, run tu run readexecutednotebook '{"datafolder":" ","search":" "}' to extract its cell outputs and apply EVERY filter/sample-exclusion the notebook used — even when the question says 'Using DESeq2/Run X/Compute Y' (this describes the METHOD the notebook used, not a request to rerun). The notebook's cell outputs are the only published authoritative answers; reimplementing or reading stale pre-computed CSVs in the data folder produces different numbers because of outlier-sample removal, library version, and filter steps you don't see by skimming. STEP 2 routing — pick a sub-skill name from this exact list (never invent): tooluniverse-rnaseq-deseq2 (RNA/miRNA-seq DE, correlation, PCA, clustering, dispersion), tooluniverse-gene-enrichment (GO/KEGG/Reactome/GSEA/pathway enrichment), tooluniverse-statistical-modeling (regression, ANOVA, ordinal/logistic, chi-square, correl
tooluniverse-drug-research
mims-harvard/tooluniverse
Comprehensive drug profiling — mechanism, primary/secondary targets, drug interactions, clinical-trial status, adverse events (FAERS), pharmacogenomics, and approval history. Use for full drug investigation reports, 'tell me about drug X' queries, and assembling drug profiles for clinicians, researchers, or regulatory work.
Popular other skills
hyperframes-cli
heygen-com/hyperframes
The HyperFrames CLI by job - scaffold, check, look at frames, edit the timeline, preview, render locally or in the cloud, publish, project history - plus reading its JSON and recovering from build or render failures.
triage
mattpocock/skills
Move issues and external PRs through a state machine of triage roles, categorise, verify, grill if needed, and write agent-ready briefs.
ask-matt
mattpocock/skills
Ask which skill or flow fits your situation. A router over the skills in this repo.
to-questionnaire
mattpocock/skills
Turn a decision you can't fully answer into a questionnaire for someone else to fill in.
loop-me
mattpocock/skills
Grill me about specs for the workflows I want to build, within this workspace.