Agent skill

Proteina Complexa

by BioTender-max in BioTender-max/awesome-bio-agent-skills

Proteina-Complexa flow-based protein backbone generation with fold-conditioned sampling guidance.

MITAuto-check: notesResearch & Science

Install Proteina Complexa

skills CLI
$ npx skills add BioTender-max/awesome-bio-agent-skills --skill proteina-complexa -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install BioTender-max/awesome-bio-agent-skills proteina-complexa --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/BioTender-max/awesome-bio-agent-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/bioclaw_hub/proteina-complexa .claude/skills/proteina-complexa && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
proteina-complexa
GitHub stars
197
Token cost
~1.4k tokens
SKILL.md length
494 words
Files
3 (incl. references)
Skills in repo
18
Repo updated
First seen
Licence
MIT

At a glance

Proteina-Complexa flow-based protein backbone generation with fold-conditioned sampling guidance.

  • Works in 4 steps: Start from backbone generation → Prefer fold-conditioned exploration → Hand off to sequence design → …
  • Generating de novo protein backbones with hierarchical fold conditioning
  • SKILL.md covers Source Notes, Prerequisites, How to Run and Recommended Use Pattern, plus 8 more sections
  • Calls git, mamba and conda; reaches github.com

What it does

Proteina Complexa is an agent skill from BioTender-max/awesome-bio-agent-skills. Proteina-Complexa flow-based protein backbone generation with fold-conditioned sampling guidance. Use this skill when: (1) Generating de novo protein backbones with hierarchical fold conditioning, (2) Exploring long-chain backbone generation beyond standard diffusion baselines, (3) Using NVIDIA Proteina-style flow matching workflows for controllable backbone design, (4) Comparing flow-based backbone generation against RFdiffusion or BoltzGen, (5) Prototyping fold-guided backbone campaigns before sequence design…

Its SKILL.md is about 1.4k tokens, which your agent loads only when the skill is triggered. The skill folder holds 3 other files, including reference files (for example `README.md` and `references/upstream-notes.md`).

It sits in Research & Science, covering Protein structure and design and Prototyping. It works with NVIDIA AI Platform. The repository describes itself as: A curated collection of AI agent skills for biomedical research, covering genomics, proteomics, single-cell analysis, clinical AI, and protein design. The licence is MIT.

When your agent uses it

  • Generating de novo protein backbones with hierarchical fold conditioning
  • Exploring long-chain backbone generation beyond standard diffusion baselines
  • Using NVIDIA Proteina-style flow matching workflows for controllable backbone design
  • Comparing flow-based backbone generation against RFdiffusion

Example prompts

  • “Proteina-Complexa”
  • “/proteina-complexa”

Requirements

  • Python 3

Workflow steps

4 steps, taken from the step headings in SKILL.md.

  1. Start from backbone generation
  2. Prefer fold-conditioned exploration
  3. Hand off to sequence design
  4. Validate and filter

What it can do on your machine

Read from SKILL.md and the folder at commit 8cbdd18. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • git
    • mamba
    • conda
    • pip

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • github.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Proteina Complexa loads about 1.4k tokens when it runs, and up to ~1.6k if it reads all its reference files. Until then it costs about 198 tokens; SKILL.md has 494 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~198
When it runs · the whole SKILL.md, loaded when a task matches
~1.4k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~1.6k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NoteMentions a .env fileSKILL.md:51
    Create a `.env` file in the repository root:
  • NoteMentions a .env fileSKILL.md:53
    cho "DATA_PATH=/path/to/proteina-data" > .env

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from BioTender-max/awesome-bio-agent-skills at commit 8cbdd18, republished under its MIT licence (© BioTender-max). 494 words, ~1,406 tokens.

Download SKILL.mdSave it as .claude/skills/proteina-complexa/SKILL.md (or your agent's skills folder). This skill also uses 2 other files; get the full folder from GitHub.
name
proteina-complexa
description
Proteina-Complexa flow-based protein backbone generation with fold-conditioned sampling guidance. Use this skill when: (1) Generating de novo protein backbones with hierarchical fold conditioning, (2) Exploring long-chain backbone generation beyond standard diffusion baselines, (3) Using NVIDIA Proteina-style flow matching workflows for controllable backbone design, (4) Comparing flow-based backbone generation against RFdiffusion or BoltzGen, (5) Prototyping fold-guided backbone campaigns before sequence design. This skill is based on the public NVIDIA Digital Bio Proteina project and uses "Proteina-Complexa" as the BioClaw-facing skill label. For sequence design after backbone generation, use proteinmpnn or solublempnn. For QC thresholds, use protein-design-qc.
license
MIT
category
design-tools
tags
structure-design, backbone-generation, flow-matching, fold-conditioning

Proteina-Complexa Backbone Generation

Plain-language role: Use this skill when you want a flow-based backbone generator with fold-class conditioning, especially for exploratory de novo design.

Source Notes

  • Public upstream reference: NVIDIA-Digital-Bio/proteina
  • Publicly described as a large-scale flow-based protein backbone generator with hierarchical fold class conditioning
  • Upstream setup and weights may change over time, so verify the current README and license before running
  • Check the upstream NVIDIA license before commercial use or redistribution of model artifacts

Prerequisites

RequirementMinimumRecommended
Python3.10+3.11
CUDA12.0+12.1+
GPU VRAM24GB40GB+
Environment managercondamamba or micromamba

How to Run

Option 1: Upstream Proteina environment
bash
git clone https://github.com/NVIDIA-Digital-Bio/proteina.git
cd proteina
mamba env create -f environment.yaml
conda activate proteina_env
pip install -e .

Create a .env file in the repository root:

bash
echo "DATA_PATH=/path/to/proteina-data" > .env
Additional files

The upstream project documents extra data and weight bundles that must live under DATA_PATH. At minimum, verify:

  • metric feature files
  • model weights
  • CATH label mapping files
  • dataset index files if you plan to train or evaluate
1. Start from backbone generation

Use Proteina-Complexa when the main task is generating diverse backbones, not sequence optimization.

2. Prefer fold-conditioned exploration

The upstream model is especially useful when you want:

  • hierarchical fold control
  • long-chain generation
  • comparison against diffusion-based backbone generators
3. Hand off to sequence design

After generating promising backbones:

  • use proteinmpnn for general inverse folding
  • use solublempnn when expression robustness matters more
4. Validate and filter

After sequence design:

  • use chai1-structure-prediction, boltz-structure-prediction, or alphafold2-multimer
  • use protein-design-qc for filtering and ranking

Typical Workflow

text
Target goal
  -> Proteina-Complexa backbone generation
  -> ProteinMPNN / SolubleMPNN sequence design
  -> Chai / Boltz / AlphaFold validation
  -> Protein Design QC

When to Prefer This Over Other Tools

NeedPrefer
Maximum backbone diversity with established community recipesrfdiffusion
All-atom generation with side-chain awarenessboltzgen
Flow-based backbone generation with fold conditioningproteina-complexa
End-to-end integrated binder pipelinebindcraft

Key Ideas to Preserve

  • Keep fold-conditioning choices explicit
  • Record which checkpoint and config produced each backbone batch
  • Separate backbone-generation artifacts from downstream sequence-design artifacts
  • Treat generated backbones as candidates that still require validation and QC
Show full SKILL.md (189 more words)Show less

Common Mistakes

  • Treating Proteina-Complexa as a sequence-design tool
  • Skipping required upstream weight and data bundles
  • Comparing outputs against RFdiffusion or BoltzGen without matching length and conditioning settings
  • Moving generated backbones directly to experiments without refolding validation

Troubleshooting

ErrorLikely causeFix
Missing DATA_PATH filesRequired upstream bundles not downloadedRe-check upstream setup and place files under the documented directory tree
CUDA OOMBackbone length or batch too largeReduce batch size or use a larger GPU
Config mismatchWrong checkpoint/config pairKeep checkpoint, config, and conditioning mode aligned
Weak downstream foldabilityBackbone exploration too unconstrainedTighten fold conditioning and validate more aggressively

Inputs

  • A backbone-generation objective such as fold-conditioned sampling, long-chain exploration, or de novo backbone discovery.
  • A configured Proteina-style environment with checkpoints, configs, and required data bundles available under the configured data path.
  • Optional fold-class or topology guidance for controlled generation.

Outputs

  • Generated protein backbone candidates suitable for downstream inverse folding.
  • Run metadata describing checkpoint choice, conditioning mode, and generation settings.
  • Backbone batches ready for sequence design with proteinmpnn or solublempnn.

Next Step

Send promising backbones to proteinmpnn or solublempnn, then validate them structurally and filter with protein-design-qc.

© BioTender-max, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 2 other files (references) in skills/bioclaw_hub/proteina-complexa of BioTender-max/awesome-bio-agent-skills.

  • SKILL.md
  • README.md
  • references/upstream-notes.md

Open the folder on GitHubat commit 8cbdd18

Compare with similar skills

Proteina Complexa next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Proteina Complexa compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Proteina Complexa this skillBioTender-max/awesome-bio-agent-skills197—~1.4kAutomated safety check: NotesMIT
Complexa Binder DesignNVIDIA-BioNeMo/bionemo-agent-toolkit478—~3.1kAutomated safety check: NotesApache-2.0
Proteinmpnn NimNVIDIA/skills3.5k1 repos~2kAutomated safety check: NotesApache-2.0
Msa Structure Prediction PipelineNVIDIA/skills3.5k1 repos~1.6kAutomated safety check: NotesApache-2.0
Openfold2 NimNVIDIA/skills3.5k1 repos~1.8kAutomated safety check: NotesApache-2.0
Rfdiffusion NimNVIDIA/skills3.5k1 repos~1.3kAutomated safety check: NotesApache-2.0

Similar skills

  • Complexa Binder Design

    NVIDIA-BioNeMo/bionemo-agent-toolkit

    Run a complete protein binder design campaign with NVIDIA Proteina-Complexa: resolve a target structure and hotspots from a name/sequence/PDB, co-design binder sequence+structure with reward-guided…

    478 GitHub stars~3.1k tokensUpdated today
    Research & ScienceAuto-check: notes
  • Proteinmpnn Nim

    NVIDIA/skills

    Official

    Run ProteinMPNN inverse folding via NVIDIA NIM to design protein sequences for a target backbone.

    3.5k GitHub starsUsed in 1 repo~2k tokens
    Research & ScienceAuto-check: notes
  • Official

    NOTE: your protein sequence and the retrieved MSA alignment are transmitted to external NVIDIA-hosted APIs (health.api.nvidia.com) on every call.

    3.5k GitHub starsUsed in 1 repo~1.6k tokens
    Research & ScienceAuto-check: notes
  • Openfold2 Nim

    NVIDIA/skills

    Official

    A skill your agent uses for OpenFold2, NVIDIA's BioNeMo NIM microservice for monomer protein structure prediction.

    3.5k GitHub starsUsed in 1 repo~1.8k tokens
    DevOps & CloudAuto-check: notes
  • Rfdiffusion Nim

    NVIDIA/skills

    Official

    Run RFDiffusion protein backbone design via NVIDIA NIM. An agent skill from NVIDIA/skills.

    3.5k GitHub starsUsed in 1 repo~1.3k tokens
    DevOps & CloudAuto-check: notes
  • Boltz2 Nim

    NVIDIA/skills

    Official

    Use Boltz2 NIM for biomolecular structure prediction and binding affinity.

    3.5k GitHub starsUsed in 1 repo~1.4k tokens
    DevOps & CloudAuto-check: notes

More from BioTender-max/awesome-bio-agent-skills

All 18 skills in this repo
  • AI Scientist Evaluator

    BioTender-max/awesome-bio-agent-skills

    Critically review, score, compare, and rank one or more AI scientist outputs for biology, bioinformatics, computational life science, or adjacent research tasks.

    197 GitHub stars~2.4k tokensUpdated 3 mo ago
    Auto-check passed
  • Jgi Lakehouse

    BioTender-max/awesome-bio-agent-skills

    Queries JGI Lakehouse (Dremio) for genomics metadata from GOLD, IMG, Mycocosm, Phytozome.

    197 GitHub stars~3.7k tokensUpdated 3 mo ago
    Auto-check passed
  • Pacsomatic

    BioTender-max/awesome-bio-agent-skills

    Operator toolkit for nf-core/pacsomatic matched tumor-normal workflows from BAM inputs.

    197 GitHub stars~1.3k tokensUpdated 3 mo ago
    Auto-check passed
  • Scientific Impact Assessment

    BioTender-max/awesome-bio-agent-skills

    Assess paper and journal impact using OpenAlex citation counts, optional Altmetric data, and curated journal impact-factor references.

    197 GitHub stars~1.2k tokensUpdated 3 mo ago
    Auto-check passed
  • Arxiv Search

    BioTender-max/awesome-bio-agent-skills

    Search arXiv preprints through the official arXiv API and turn arXiv IDs into local Markdown summaries.

    197 GitHub stars~2.9k tokensUpdated 3 mo ago
    Auto-check passed
  • Biorxiv Search

    BioTender-max/awesome-bio-agent-skills

    Search bioRxiv preprints through the official bioRxiv API and locally filter titles, abstracts, and authors for keyword queries.

    197 GitHub stars~2.4k tokensUpdated 3 mo ago
    Auto-check passed

Questions about Proteina Complexa

What does Proteina Complexa do?

Proteina-Complexa flow-based protein backbone generation with fold-conditioned sampling guidance. Proteina Complexa is an agent skill from BioTender-max/awesome-bio-agent-skills. Proteina-Complexa flow-based protein backbone generation with fold-conditioned sampling guidance.

When should I use Proteina Complexa?

Proteina Complexa fits situations like: generating de novo protein backbones with hierarchical fold conditioning; exploring long-chain backbone generation beyond standard diffusion baselines; using NVIDIA Proteina-style flow matching workflows for controllable backbone design; comparing flow-based backbone generation against RFdiffusion.

How do I install Proteina Complexa in Claude Code?

Run `npx skills add BioTender-max/awesome-bio-agent-skills --skill proteina-complexa -a claude-code`. Or copy the skill folder (skills/bioclaw_hub/proteina-complexa in BioTender-max/awesome-bio-agent-skills) into .claude/skills/proteina-complexa in your project. Claude Code loads it when a task matches its description.

How do I install Proteina Complexa in Codex?

Run `npx skills add BioTender-max/awesome-bio-agent-skills --skill proteina-complexa -a codex`. Or copy the skill folder (skills/bioclaw_hub/proteina-complexa in BioTender-max/awesome-bio-agent-skills) into .agents/skills/proteina-complexa in your project. Codex loads it when a task matches its description.

Can I use Proteina Complexa in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add BioTender-max/awesome-bio-agent-skills --skill proteina-complexa -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/proteina-complexa, .gemini/skills/proteina-complexa, .github/skills/proteina-complexa and .opencode/skills/proteina-complexa in your project.

What does Proteina Complexa need to run?

Going by SKILL.md and its folder, Proteina Complexa needs the command-line tools its instructions call (git, mamba, conda and pip). Our summary lists: Python 3.

Does Proteina Complexa access the network?

SKILL.md names 1 domain. In commands or code: github.com; the agent is likely to contact it when it follows the instructions. This is read from the text; nothing was executed.

Is Proteina Complexa safe to install?

Our automated static check of SKILL.md found notes only (mentions a .env file), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.

What licence does Proteina Complexa use?

Proteina Complexa is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Proteina Complexa use?

About 1.4k tokens (SKILL.md is roughly 5.6k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 240 tokens, read only when the agent opens those files.

What are the alternatives to Proteina Complexa?

Skills that share tags, products or a category with Proteina Complexa: Complexa Binder Design (NVIDIA-BioNeMo/bionemo-agent-toolkit, 478 stars), Proteinmpnn Nim (NVIDIA/skills, 3.5k stars), Msa Structure Prediction Pipeline (NVIDIA/skills, 3.5k stars) and Openfold2 Nim (NVIDIA/skills, 3.5k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Proteina Complexa?

BioTender-max (a GitHub user) maintains it in BioTender-max/awesome-bio-agent-skills, which has 197 GitHub stars. The repository holds 18 skills in this directory. The repository was last updated on July 1, 2026.

Source: BioTender-max/awesome-bio-agent-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.