tooluniverse-protein-therapeutic-design

mims-harvard/tooluniverse · updated Apr 8, 2026

MDX-style export adds YAML metadata + attribution linking explainx.ai and this canonical listing URL.

$npx skills add https://github.com/mims-harvard/tooluniverse --skill tooluniverse-protein-therapeutic-design
0 commentsdiscussion
summary

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

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]_protein_design_report.md first with section headers
  2. Progressively update as designs are generated
  3. Output [TARGET]_designed_sequences.fasta and [TARGET]_top_candidates.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
NvidiaNIM_rfdiffusion Backbone generation diffusion_steps (NOT num_steps)
NvidiaNIM_proteinmpnn Sequence design pdb_string (NOT pdb)
ESMFold_predict_structure Fast validation sequence (NOT seq)
NvidiaNIM_alphafold2 High-accuracy validation sequence, algorithm
NvidiaNIM_esm2_650m Sequence embeddings sequences, format

Common Parameter Mistakes

Tool Wrong Correct
NvidiaNIM_rfdiffusion num_steps=50 diffusion_steps=50
NvidiaNIM_proteinmpnn pdb=content pdb_string=content
ESMFold_predict_structure seq="MVLS..." sequence="MVLS..."
NvidiaNIM_alphafold2 seq="MVLS..." sequence="MVLS..."

NVIDIA NIM Requirements

  • API Key: NVIDIA_API_KEY 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
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 Search cryo-EM maps query
emdb_get_entry Get entry details entry_id
UniProt_get_entry_by_accession Get target sequence accession
InterPro_get_protein_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
how to use tooluniverse-protein-therapeutic-design

How to use tooluniverse-protein-therapeutic-design on Cursor

AI-first code editor with Composer

1

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-protein-therapeutic-design
2

Execute installation command

Execute the skills CLI command in your project's root directory to begin installation:

$npx skills add https://github.com/mims-harvard/tooluniverse --skill tooluniverse-protein-therapeutic-design

The skills CLI fetches tooluniverse-protein-therapeutic-design from GitHub repository mims-harvard/tooluniverse and configures it for Cursor.

3

Select Cursor when prompted

The CLI will show a list of available agents. Use arrow keys to navigate and space to select Cursor:

◆ Which agents do you want to install to?
│ ── Universal (.agents/skills) ── always included ────
│ • Amp
│ • Antigravity
│ • Cline
│ • Codex
│ ●Cursor(selected)
│ • Cursor
│ • Windsurf
4

Verify installation

Confirm successful installation by checking the skill directory location:

.cursor/skills/tooluniverse-protein-therapeutic-design

Reload or restart Cursor to activate tooluniverse-protein-therapeutic-design. Access the skill through slash commands (e.g., /tooluniverse-protein-therapeutic-design) 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

GET_STARTED →

Use Cases

Task Automation & Efficiency

Automate repetitive workflows and reduce manual effort

Example

Generate reports, summarize documents, draft communications

Save 3-5 hours per week on routine tasks

Knowledge Enhancement

Learn new skills, understand complex topics, get expert guidance

Example

Explain concepts, provide examples, suggest learning resources

Accelerate learning and skill development by 2x

Quality Improvement

Enhance output quality through reviews, suggestions, and refinements

Example

Review drafts, suggest improvements, catch errors

Improve work quality by 30-40% with less effort

Implementation Guide

Prerequisites

  • Claude Desktop or compatible AI client with skill support
  • Clear understanding of task or problem to solve
  • Willingness to iterate and refine outputs

Time Estimate

15-45 minutes depending on use case complexity

Installation Steps

  1. 1.Install skill using provided installation command
  2. 2.Test with simple use case relevant to your work
  3. 3.Evaluate output quality and relevance
  4. 4.Iterate on prompts to improve results
  5. 5.Integrate into regular workflow if valuable

Common Pitfalls

  • Expecting perfect results without iteration
  • Not providing enough context in prompts
  • Using skill for tasks outside its intended scope
  • Accepting outputs without review and validation

Best Practices

✓ Do

  • +Start with clear, specific prompts
  • +Provide relevant context and constraints
  • +Review and refine all outputs before using
  • +Iterate to improve output quality
  • +Document successful prompt patterns

✗ Don't

  • Don't use without understanding skill limitations
  • Don't skip validation of outputs
  • Don't share sensitive information in prompts
  • Don't expect skill to replace human judgment

💡 Pro Tips

  • Be specific about desired format and style
  • Ask for multiple options to choose from
  • Request explanations to understand reasoning
  • Combine AI efficiency with human expertise

When to Use This

✓ Use When

Use when skill capabilities match your task, clear ROI on time saved, and you can validate outputs. Best for repetitive tasks, learning, and quality improvement.

✗ Avoid When

Avoid when task requires deep expertise you can't validate, involves sensitive decisions, or when learning process is more valuable than speed of completion.

Learning Path

  1. 1Familiarize yourself with skill capabilities and limitations
  2. 2Start with low-risk, non-critical tasks
  3. 3Progress to more complex and valuable use cases
  4. 4Build expertise through regular use and experimentation

Discussion

Product Hunt–style comments (not star reviews)
  • No comments yet — start the thread.
general reviews

Ratings

4.748 reviews
  • Shikha Mishra· Dec 20, 2024

    I recommend tooluniverse-protein-therapeutic-design for anyone iterating fast on agent tooling; clear intent and a small, reviewable surface area.

  • Ganesh Mohane· Dec 20, 2024

    We added tooluniverse-protein-therapeutic-design from the explainx registry; install was straightforward and the SKILL.md answered most questions upfront.

  • Zara Okafor· Dec 20, 2024

    Registry listing for tooluniverse-protein-therapeutic-design matched our evaluation — installs cleanly and behaves as described in the markdown.

  • Aarav Brown· Dec 12, 2024

    I recommend tooluniverse-protein-therapeutic-design for anyone iterating fast on agent tooling; clear intent and a small, reviewable surface area.

  • William Menon· Dec 8, 2024

    Useful defaults in tooluniverse-protein-therapeutic-design — fewer surprises than typical one-off scripts, and it plays nicely with `npx skills` flows.

  • Yusuf Jain· Nov 27, 2024

    I recommend tooluniverse-protein-therapeutic-design for anyone iterating fast on agent tooling; clear intent and a small, reviewable surface area.

  • Yash Thakker· Nov 11, 2024

    Useful defaults in tooluniverse-protein-therapeutic-design — fewer surprises than typical one-off scripts, and it plays nicely with `npx skills` flows.

  • Dev Tandon· Nov 11, 2024

    tooluniverse-protein-therapeutic-design fits our agent workflows well — practical, well scoped, and easy to wire into existing repos.

  • Aisha Srinivasan· Nov 3, 2024

    Useful defaults in tooluniverse-protein-therapeutic-design — fewer surprises than typical one-off scripts, and it plays nicely with `npx skills` flows.

  • Zara Abebe· Oct 22, 2024

    tooluniverse-protein-therapeutic-design has been reliable in day-to-day use. Documentation quality is above average for community skills.

showing 1-10 of 48

1 / 5