Official agent skill

Openfold2 Nim

by NVIDIA in NVIDIA/skills

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

OfficialApache-2.0Auto-check: notesDevOps & Cloud

Install Openfold2 Nim

skills CLI
$ npx skills add NVIDIA/skills --skill openfold2-nim -a claude-code

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

GitHub CLI
$ gh skill install NVIDIA/skills openfold2-nim --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/NVIDIA/skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/bionemo-openfold2-nim .claude/skills/openfold2-nim && 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
openfold2-nim
GitHub stars
3.5k
Used in
1 other repo
Token cost
~1.8k tokens
SKILL.md length
612 words
Files
13 (incl. references)
Skills in repo
380
Repo updated
First seen
Licence
Apache-2.0

At a glance

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

  • NVIDIAs BioNeMo NIM microservice for monomer protein structure prediction
  • SKILL.md covers Choose Mode, Auth And Environment, Local Docker and Request Pattern, plus 2 more sections
  • Calls docker; reaches health.api.nvidia.com; needs NGC_API_KEY and NVIDIA_API_KEY
  • Mentions OpenFold2

What it does

Openfold2 Nim is an agent skill from NVIDIA/skills, published by the product's own GitHub organization. Use this skill for OpenFold2, NVIDIA's BioNeMo NIM microservice for monomer protein structure prediction. Invoke whenever the user mentions OpenFold2, AlphaFold2-like monomer folding, protein sequence-to-structure prediction, A3M MSAs, mmCIF templates, hosted NVIDIA API calls, or local Docker deployment.

Its SKILL.md is about 1.8k tokens, which your agent loads only when the skill is triggered. The skill folder holds 15 other files, including reference files (for example `BENCHMARK.md`, `config/skillspector-baseline.yml` and `evals/config.yml`). Compatibility notes: requests=2.28

It sits in DevOps & Cloud, covering Protein structure and design, Containers and Microservices. It works with NVIDIA AI Platform and Docker. The repository describes itself as: Agent Skills for NVIDIA products — install into Claude Code, Codex, and other coding agents to run Physical AI, robotics, simulation, CUDA, and RAG workflows end to end. The licence is Apache-2.0.

When your agent uses it

  • NVIDIAs BioNeMo NIM microservice for monomer protein structure prediction
  • Mentions OpenFold2
  • AlphaFold2-like monomer folding
  • Protein sequence-to-structure prediction

Example prompts

  • “/openfold2-nim”

Requirements

  • Python 3
  • Docker
  • A credential in NGC_API_KEY
  • A credential in NVIDIA_API_KEY
  • Compatibility (from SKILL.md): requests>=2.28
  • Pre-approved tools (allowed-tools): Bash, Read, Write, AskUserQuestion

What it can do on your machine

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

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • Bash
    • Read
    • Write
    • AskUserQuestion

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • docker

    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:

    • health.api.nvidia.com

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

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • NGC_API_KEY
    • NVIDIA_API_KEY

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

  • Compatibility

    requests>=2.28

    From compatibility in the SKILL.md frontmatter.

Context cost

Openfold2 Nim loads about 1.8k tokens when it runs, and up to ~5k if it reads all its reference files. Until then it costs about 80 tokens; SKILL.md has 612 words of instructions outside code blocks.

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

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:43
    `LOCAL_NIM_CACHE`. A repo-root `.env` file may be sourced as a local override.
  • NoteMentions a .env fileSKILL.md:52
    For the exact startup preflight (`.env` sourcing, `NGC_API_KEY`/`NVIDIA_API_KEY`
  • NoteMentions a .env fileSKILL.md:56
    not drop `.env`, `NGC_API_KEY`, `LOCAL_NIM_CACHE`, or the no-auth local request.
  • NotePre-approves every shell command (allowed-tools: Bash)SKILL.md
    allowed-tools: Bash, Read, Write, AskUserQuestion

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 NVIDIA/skills at commit 0e0d506, republished under its Apache-2.0 licence (© NVIDIA). 612 words, ~1,802 tokens.

Download SKILL.mdSave it as .claude/skills/openfold2-nim/SKILL.md (or your agent's skills folder). This skill also uses 12 other files; get the full folder from GitHub.
name
openfold2-nim
description
Use this skill for OpenFold2, NVIDIA's BioNeMo NIM microservice for monomer protein structure prediction. Invoke whenever the user mentions OpenFold2, AlphaFold2-like monomer folding, protein sequence-to-structure prediction, A3M MSAs, mmCIF templates, hosted NVIDIA API calls, or local Docker deployment.
allowed-tools
Bash, Read, Write, AskUserQuestion
compatibility
requests>=2.28
license
Apache-2.0 AND CC-BY-4.0

OpenFold2 NIM

Predict a single protein-chain structure from an amino-acid sequence, with optional A3M multiple sequence alignments and mmCIF templates. Use this guide for basic hosted/local NIM use; load supplemental files only when the task needs deeper context:

  • references/api.md: exact endpoints, schemas, Docker flags, response fields.
  • references/science.md: model scope, strengths, limitations, and handoffs.
  • references/parameters.md: MSA, template, model-selection, and relax effects.
  • references/validation.md: artifact and scientific sanity checks.
  • references/examples.md: compact hosted/local payload patterns.

Choose Mode

Ask only when context is unclear:

Hosted NVIDIA API or local Docker NIM?

  • Hosted URL: https://health.api.nvidia.com/v1/biology/openfold/openfold2/predict-structure-from-msa-and-template
  • Local URL: http://localhost:8000/biology/openfold/openfold2/predict-structure-from-msa-and-template
  • Local readiness: http://localhost:8000/v1/health/ready

Mode difference: hosted and local use the same prediction path except local does not include /v1/. Hosted requests use Authorization: Bearer $NGC_API_KEY; local inference requests use no auth header after readiness.

Auth And Environment

Do not print API keys. Confirm they exist with shell tests, not echoes.

Hosted needs NGC_API_KEY in the request header. Supported local Docker startup uses NGC_API_KEY, or NVIDIA_API_KEY as a fallback, plus LOCAL_NIM_CACHE. A repo-root .env file may be sourced as a local override.

Local Docker

Use the official OpenFold2 NIM image and mount LOCAL_NIM_CACHE at /opt/nim/.cache. Current docs recommend at least 80 GB disk, 64 GB system RAM, 8 CPU cores, and one supported GPU; the container is roughly 55 GB and first startup downloads about 10 GB of model parameters.

For the exact startup preflight (.env sourcing, NGC_API_KEY/NVIDIA_API_KEY handling, docker login, and the docker run for nvcr.io/nim/openfold/openfold2:latest), copy the command block in references/api.md under Local Docker verbatim — do not drop .env, NGC_API_KEY, LOCAL_NIM_CACHE, or the no-auth local request.

Readiness check:

bash
until curl -sf http://localhost:8000/v1/health/ready; do sleep 5; done

Request Pattern

Use Python requests; curl escaping is fragile for A3M/mmCIF text. The sequence field is required. input_id, alignments, selected_models, relax_prediction, use_templates, and explicit_templates are optional.

python
import os
import requests

hosted = True
url = (
    "https://health.api.nvidia.com/v1/biology/openfold/openfold2/predict-structure-from-msa-and-template"
    if hosted
    else "http://localhost:8000/biology/openfold/openfold2/predict-structure-from-msa-and-template"
)
headers = {"Content-Type": "application/json"}
if hosted:
    headers["Authorization"] = f"Bearer {os.getenv('NGC_API_KEY')}"

seq = "MTEYKLVVVGAGGVGKSALTIQLIQNHFVDEYDPT"
payload = {
    "sequence": seq,
    "input_id": "kras_fragment",
    "selected_models": [1],
    "relax_prediction": False,
    "alignments": {
        "uniref90": {
            "a3m": {
                "alignment": f">query\n{seq}",
                "format": "a3m",
            }
        }
    },
}

response = requests.post(url, headers=headers, json=payload, timeout=300)
response.raise_for_status()
result = response.json()

Payload gotchas:

  • OpenFold2 is monomer-only. For protein-ligand, protein-DNA/RNA, or multi-chain complexes, use OpenFold3 or Boltz2 instead.
  • sequence must use valid amino-acid IUPAC symbols.
  • Hosted API docs list sequence length 1-1000; local docs say current NIM supports sequences up to 2048 residues on supported hardware.
  • A3M alignments go under alignments by database name, then a3m with alignment and format. When the user needs to create or deepen an MSA, hand off to msa-search-nim / MSA Search and map its A3M output into this alignments shape.
  • Starting with OpenFold2 2.0.0, use explicit_templates with mmCIF content; do not write new HHR-template examples.
  • selected_models chooses AlphaFold2/OpenFold parameter sets 1-5. Select one or two models for smoke tests; use all five for stronger production runs.
Show full SKILL.md (206 more words)Show less

Save And Interpret Output

The response includes one prediction per selected model, ordered by confidence. Save every returned structure-like text field and the full JSON response so field-shape differences are auditable. Production answers should explicitly write .pdb or .cif artifacts, preserve the response JSON, and print any confidence/ranking fields the service returns.

python
from pathlib import Path
import json

Path("openfold2_response.json").write_text(json.dumps(result, indent=2))

def save_strings(obj, prefix="openfold2"):
    i = 0
    if isinstance(obj, dict):
        for key, value in obj.items():
            if isinstance(value, str) and ("ATOM" in value or value.lstrip().startswith("data_")):
                i += 1
                ext = "cif" if value.lstrip().startswith("data_") else "pdb"
                Path(f"{prefix}_{key}_{i}.{ext}").write_text(value)
            elif isinstance(value, (dict, list)):
                i += save_strings(value, f"{prefix}_{key}")
    elif isinstance(obj, list):
        for idx, value in enumerate(obj, start=1):
            if isinstance(value, (dict, list)):
                i += save_strings(value, f"{prefix}_{idx}")
    return i

saved = save_strings(result)
print(f"saved {saved} structure artifact(s)")

For production monomer runs:

  • Use selected_models: [1, 2, 3, 4, 5] unless the user requests a smoke test.
  • Use relax_prediction: True in Python payloads when relaxation is desired; JSON examples may show true.
  • State the sequence length caveat: hosted API docs list 1-1000 residues, while local support-matrix docs list up to 2048 residues on supported hardware.
  • If the task is a complex rather than a monomer, redirect to OpenFold3 or Boltz2.

Treat tiny toy sequences and single-sequence MSAs as API smoke tests, not quality evidence. For scientific interpretation and validation, read references/science.md and references/validation.md.

Troubleshooting

  • 401: missing, expired, or unauthorized NGC API key.
  • 422: invalid amino-acid characters, sequence too long, malformed A3M, bad selected_models, or malformed mmCIF template object.
  • Local 404: remove /v1/ from the prediction URL.
  • Weak structures: use MSA Search to generate deeper A3M alignments and add biologically relevant mmCIF templates when appropriate.
  • Local startup stalls: first run downloads parameters into LOCAL_NIM_CACHE.

© NVIDIA, Apache-2.0. 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 12 other files (references) in skills/bionemo-openfold2-nim of NVIDIA/skills.

  • SKILL.md
  • BENCHMARK.md
  • config/skillspector-baseline.yml
  • evals/config.yml
  • evals/evals.json
  • evals/trigger_evals.json
  • references/api.md
  • references/examples.md
  • references/parameters.md
  • references/science.md
  • references/validation.md
  • skill-card.md
  • skill.oms.sig

Open the folder on GitHubat commit 0e0d506

Used in 1 other repository

We found 2 copies of this SKILL.md (exact, near-identical or edited) in other folders, from 1 other GitHub owner. This page covers the copy in NVIDIA/skills, which our catalogue first saw on October 7, 2026.

Compare with similar skills

Openfold2 Nim 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.

Openfold2 Nim compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Openfold2 Nim this skillNVIDIA/skills3.5k1 repos~1.8kAutomated safety check: NotesApache-2.0
Frontmcp Deploymentagentfront/frontmcp146—~9.2kAutomated safety check: NotesApache-2.0
Model Download Devopen-edge-platform/edge-ai-libraries168—~2kAutomated safety check: PassApache-2.0
Time Series Analytics Devopen-edge-platform/edge-ai-libraries168—~1.5kAutomated safety check: NotesApache-2.0
Supabasemagnus919/agent-skills111—~2.2kAutomated safety check: PassMIT
Setup Workshopbrevdev/workshop-build-an-agent143—~2.3kAutomated safety check: NotesApache-2.0

Similar skills

  • Frontmcp Deployment

    agentfront/frontmcp

    A skill your agent uses when deploying, building for production, packaging, or shipping a FrontMCP server.

    146 GitHub stars~9.2k tokensUpdated today
    DevOps & CloudAuto-check: notes
  • Model Download Dev

    open-edge-platform/edge-ai-libraries

    Extend, test, debug, or integrate the Model Download microservice codebase.

    168 GitHub stars~2k tokensUpdated today
    DevOps & CloudAuto-check passed
  • Time Series Analytics Dev

    open-edge-platform/edge-ai-libraries

    Develop the Time Series Analytics microservice itself (FastAPI + Kapacitor) — build and deploy it locally via Docker Compose or Helm, run the mocked unit test suite (tests/runtests.sh) and the…

    168 GitHub stars~1.5k tokensUpdated today
    DevOps & CloudAuto-check: notes
  • Supabase

    magnus919/agent-skills

    A skill your agent uses when developing applications with Supabase, running the Supabase CLI, designing migrations and RLS policies, testing database behavior, generating client types, deploying the…

    111 GitHub stars~2.2k tokensUpdated yesterday
    DevOps & CloudAuto-check passed
  • Setup Workshop

    brevdev/workshop-build-an-agent

    This skill should be used when the user wants to set up, install, deploy, bootstrap, or "spin up" the Build-an-Agent workshop (a.k.a.

    143 GitHub stars~2.3k tokensUpdated yesterday
    DevOps & CloudAuto-check: notes
  • Generate Nemo Gym Env

    adithya-s-k/FineEnvs

    Builds a NeMo Gym (NVIDIA) variant of an RL environment. An agent skill from adithya-s-k/FineEnvs.

    421 GitHub stars~2.1k tokensUpdated yesterday
    DevOps & CloudAuto-check passed

More from NVIDIA/skills

All 380 skills in this repo
  • Official

    A skill your agent uses when the user wants to deploy, run, debug, tear down, or call the REST API of the RTVI-CV 2D detection / tracking microservice.

    3.5k GitHub starsUsed in 1 repo~4.5k tokens
    Auto-check passed
  • Official

    Generates, validates, compares and explains HOLOLINK_def.svh macro files for the HSB IP, using bundled Python scripts and asking before it writes anything.

    3.5k GitHub stars~2.9k tokensUpdated yesterday
    Auto-check passed
  • Official

    Runs and validates an end-to-end Mission Control demo in a locally installed Isaac Sim, with a Nova Carter robot driven through a Python server.

    3.5k GitHub stars~4.8k tokensUpdated yesterday
    Auto-check passed
  • Orchestrates defect image generation for PCBA, metal surface and glass inspection with NVIDIA Cosmos AnomalyGen on OSMO, from cold-start Day 0 to real-photo Day 1 labeling.

    3.5k GitHub stars~5k tokensUpdated yesterday
    Auto-check: notes
  • Orchestrates video data augmentation and auto-labeling workflows on OSMO, from flow selection and preflight checks to submission, monitoring and output download.

    3.5k GitHub stars~4.7k tokensUpdated yesterday
    Auto-check: notes
  • Official

    Runs NVIDIA TAO Data Services KPI analysis on object detection results, comparing predictions to ground truth and writing per-class precision, recall and AP to a CSV.

    3.5k GitHub stars~2.7k tokensUpdated yesterday
    Auto-check: notes

Questions about Openfold2 Nim

What does Openfold2 Nim do?

A skill your agent uses for OpenFold2, NVIDIA's BioNeMo NIM microservice for monomer protein structure prediction. Openfold2 Nim is an agent skill from NVIDIA/skills, published by the product's own GitHub organization. Use this skill for OpenFold2, NVIDIA's BioNeMo NIM microservice for monomer protein structure prediction.

When should I use Openfold2 Nim?

Openfold2 Nim fits situations like: NVIDIAs BioNeMo NIM microservice for monomer protein structure prediction; mentions OpenFold2; alphaFold2-like monomer folding; protein sequence-to-structure prediction.

How do I install Openfold2 Nim in Claude Code?

Run `npx skills add NVIDIA/skills --skill openfold2-nim -a claude-code`. Or copy the skill folder (skills/bionemo-openfold2-nim in NVIDIA/skills) into .claude/skills/openfold2-nim in your project. Claude Code loads it when a task matches its description.

How do I install Openfold2 Nim in Codex?

Run `npx skills add NVIDIA/skills --skill openfold2-nim -a codex`. Or copy the skill folder (skills/bionemo-openfold2-nim in NVIDIA/skills) into .agents/skills/openfold2-nim in your project. Codex loads it when a task matches its description.

Can I use Openfold2 Nim 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 NVIDIA/skills --skill openfold2-nim -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/openfold2-nim, .gemini/skills/openfold2-nim, .github/skills/openfold2-nim and .opencode/skills/openfold2-nim in your project.

What does Openfold2 Nim need to run?

Going by SKILL.md and its folder, Openfold2 Nim needs the command-line tools its instructions call (docker) and credentials named NGC_API_KEY and NVIDIA_API_KEY. Our summary lists: Python 3; Docker; A credential in NGC_API_KEY; A credential in NVIDIA_API_KEY. Its frontmatter pre-approves these tools: Bash, Read, Write, AskUserQuestion. Compatibility (from SKILL.md): requests>=2.28.

Does Openfold2 Nim access the network?

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

Is Openfold2 Nim safe to install?

Our automated static check of SKILL.md found notes only (mentions a .env file; pre-approves every shell command (allowed-tools: bash)), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.

What licence does Openfold2 Nim use?

Openfold2 Nim is published under the Apache-2.0 licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Openfold2 Nim use?

About 1.8k tokens (SKILL.md is roughly 7.2k 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 3.2k tokens, read only when the agent opens those files.

What are the alternatives to Openfold2 Nim?

Skills that share tags, products or a category with Openfold2 Nim: Frontmcp Deployment (agentfront/frontmcp, 146 stars), Model Download Dev (open-edge-platform/edge-ai-libraries, 168 stars), Time Series Analytics Dev (open-edge-platform/edge-ai-libraries, 168 stars) and Supabase (magnus919/agent-skills, 111 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Openfold2 Nim?

NVIDIA (a GitHub organization, an official publisher) maintains it in NVIDIA/skills, which has 3,534 GitHub stars. The repository holds 380 skills in this directory. The repository was last updated on October 7, 2026.

Source: NVIDIA/skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.