SkillAgentSearch skills...

ColabFold MSA server (api.colabfold.com)

Structure prediction using OpenFold3, an open-weights PyTorch reproduction of AlphaFold3 from the AlQuraishi Lab. Use this skill when predicting protein/nucleic-acid/ligand complex structures with an Apache-2.0-licensed AF3 reimplementation.

Install / Use

npx skills add aipoch/open-science --skill openfold3

Installs into whichever agent you are using.

About this skill
📄

SKILL.md

Installable skill definition

Quality Score

94/100

Supported Platforms

Universal

Our assessment of ColabFold MSA server (api.colabfold.com)

ColabFold MSA server (api.colabfold.com) scores 94/100 on our quality scale, 493rd of 4,700 Development & Engineering skills we index (top 11%).

Its SKILL.md is 9.8 KB long, well organised into 12 sections with 7 code examples: a thorough specification that gives an agent plenty to work with.

With 4,918 GitHub stars, it is one of the more widely adopted skills in the catalogue.

Substance
29/30
Structure
20/20
Description
15/15
Adoption
16/20
Freshness
15/15

Maintenance, license and trust

  • The repository was last updated about 2 months ago, so ColabFold MSA server (api.colabfold.com) is actively maintained.
  • Our last check on 2026-11-16 found the source still online.
  • It is released under the Apache-2.0 license, a permissive license that allows use, modification and commercial use with attribution.
  • Its trust signals score 100/100, with no cautions. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.

Safety scan

No issues found

Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.

AI review by kimi-k2.7-code on 2026-09-29. Automated pattern scan on 2026-09-28. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.

ColabFold MSA server (api.colabfold.com) compared with similar skills

All 4 of these similar skills score higher than ColabFold MSA server (api.colabfold.com); compare them before choosing.

SkillScoreStarsUpdatedFormat
ColabFold MSA server (api.colabfold.com) (this skill)by aipoch944.9k53d agoSKILL.md
taste-skillby Leonxlnx100116.8k8d agoCLAUDE.md
Agent-Reachby Panniantong100112.3k8d agoCLAUDE.md
headroomby headroomlabs-ai10079.8ktodayCLAUDE.md
ai-job-searchby ai-job-search-dev10072.1ktodayCLAUDE.md

Frequently asked questions

How do I install ColabFold MSA server (api.colabfold.com)?
Run npx skills add aipoch/open-science --skill "ColabFold MSA server (api.colabfold.com)". The install tabs above show the steps for each supported agent.
Which AI agents does ColabFold MSA server (api.colabfold.com) work with?
It is written for Universal, as a SKILL.md file. Other agents that read the same format can often use it too.
Is ColabFold MSA server (api.colabfold.com) safe to use?
Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It is Apache-2.0-licensed and scores 100/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
Is ColabFold MSA server (api.colabfold.com) still maintained?
The repository was last updated about 2 months ago, so ColabFold MSA server (api.colabfold.com) is actively maintained.

name: openfold3 description: > Structure prediction using OpenFold3, an open-weights PyTorch reproduction of AlphaFold3 from the AlQuraishi Lab. Use this skill when predicting protein/nucleic-acid/ligand complex structures with an Apache-2.0-licensed AF3 reimplementation. license: Apache-2.0 category: biomodels requirements: [gpu] metadata: display-name: OpenFold3

github.com/aqlaboratory/openfold-3/blob/main/LICENSE: Apache-2.0. HF model

card and gated prompt confirm. verified 2026-06-30

third_party: - kind: weights name: OpenFold3 provider: OpenFold Consortium license: Apache-2.0 terms_url: https://github.com/aqlaboratory/openfold-3/blob/main/LICENSE # SKILL.md — --use-msa-server DEFAULTS to true (MSA server is # api.colabfold.com), so the sequence leaves the machine unless opted out. # No published ToS — wiki is the closest data-use reference. - kind: service name: ColabFold MSA server (api.colabfold.com) provider: Steinegger Lab info_url: https://github.com/sokrypton/ColabFold/wiki

OpenFold3 Structure Prediction

Prerequisites

| Requirement | Minimum | Recommended | | -------------- | ------- | ----------- | | Python | 3.10+ | 3.11 | | CUDA | 12.1+ | 12.4+ | | GPU VRAM | 24GB | 80GB (H100) | | RAM | 32GB | 64GB | | Disk (weights) | 3GB | - |

How to run

Installation

pip install 'openfold3[cuequivariance]==0.4.1'

The default attention kernel is DeepSpeed DS4Sci_EvoformerAttention. If DeepSpeed is unavailable, switch to the cuEquivariance triangle kernels (no build-from-source) by overriding the eval memory settings in model_config.py (use_deepspeed_evo_attention: False, use_cueq_triangle_kernels: True). Some pre-built environments already ship this override; check before re-patching.

Weights

Apache-2.0, ~2.3 GB from HF OpenFold/OpenFold3. The repo is gated (auto-approval) — accept the access form on the HF model page and authenticate (huggingface-cli login or HF_TOKEN) before downloading:

export OPENFOLD_CACHE=~/.openfold3
huggingface-cli download OpenFold/OpenFold3 checkpoints/of3-p2-155k.pt \
  --local-dir "$OPENFOLD_CACHE"

run_openfold will also auto-download to $OPENFOLD_CACHE on first run if egress is open and HF credentials are available (either HF_TOKEN or a prior huggingface-cli login) with repo access granted. The interactive setup_openfold helper exists but prompts on stdin; prefer the explicit download above for non-interactive runs.

Running

export OPENFOLD_CACHE=/path/to/cache
run_openfold predict \
  --query_json=queries.json \
  --output-dir out/ \
  --use-msa-server false \
  --use-templates false

run_openfold discovers the checkpoint under $OPENFOLD_CACHE automatically. Only pass --inference-ckpt-path <file.pt> if you have a non-standard layout or multiple checkpoints and need to pin one explicitly.

For MSA + templates (slower, higher accuracy), drop the two false flags. The MSA server is api.colabfold.com; template chain-ID remap hits data.rcsb.org (GraphQL) — both must be reachable.

Query JSON format

OpenFold3 does not read FASTA. Queries are a JSON object validated by InferenceQuerySet (pydantic, extra: forbid — unknown keys reject):

{
  "queries": {
    "my_complex": {
      "chains": [
        { "molecule_type": "protein", "chain_ids": ["A"], "sequence": "MQIFVK…" },
        { "molecule_type": "protein", "chain_ids": ["B", "C"], "sequence": "MVLSPA…" },
        { "molecule_type": "ligand", "chain_ids": ["L"], "smiles": "CC(=O)Oc1ccccc1C(=O)O" }
      ],
      "use_msas": true
    }
  },
  "seeds": [42]
}

| molecule_type | required field | | ------------------------- | ------------------------------------ | | protein / dna / rna | sequence | | ligand | smiles or ccd_codes: ["HEM"] |

chain_ids is a list — repeat the same sequence across multiple chain IDs for homo-oligomers. Per-chain paired_msa_file_paths / main_msa_file_paths let you supply your own a3m instead of the server.

Key parameters

| Flag | Default | Description | | ------------------------- | --------------------------------------- | ------------------------------------------------------------------------------------------------------ | | --num-diffusion-samples | 5 | Structures per (query, seed) | | --num-model-seeds | 1 | Number of model seeds per query (multiplies output count alongside JSON seeds and diffusion samples) | | --use-msa-server | true | ColabFold MMseqs2 server for MSA | | --use-templates | true | ColabFold template search + RCSB remap | | --inference-ckpt-path | auto-discovered under $OPENFOLD_CACHE | Override only — for non-standard layouts or to pin a specific checkpoint file |

Output format

out/
├── summary.txt
├── model_config.json / experiment_config.json
├── inference_query_set.json
└── <query_name>/seed_<N>/
    ├── <query>_seed_<N>_sample_<k>_model.cif
    ├── <query>_seed_<N>_sample_<k>_confidences.json           # full PAE/pLDDT
    ├── <query>_seed_<N>_sample_<k>_confidences_aggregated.json
    └── timing.json

*_confidences_aggregated.json is the small one to read first:

{
  "avg_plddt": 78.96,
  "ptm": 0.667,
  "iptm": 0.0,
  "gpde": 0.73,
  "has_clash": 0.0,
  "sample_ranking_score": 0.133,
  "chain_ptm": { "A": 0.667 },
  "chain_pair_iptm": {}
}

What good output looks like

  • summary.txt shows Successful Queries: N matching your input count
  • avg_plddt > 70 (single-seq) / > 80 (with MSA)
  • ptm > 0.6; for complexes, iptm > 0.5
  • has_clash: 0.0
  • .cif ~50-150 KB per sample for a small protein

Verify

grep -E 'Successful|Failed' out/summary.txt
find out -name '*_model.cif' | wc -l   # = queries x json_seeds x num-model-seeds x num-diffusion-samples

Troubleshooting

| Error | Cause | Fix | | -------------------------------------------------------------------------- | ------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | _deepspeed_evo_attn requires that DeepSpeed be installed | default eval kernel is DS4Sci on CUDA | install deepspeed (needs nvcc + CUTLASS), or in model_config.py eval block set use_deepspeed_evo_attention: False + use_cueq_triangle_kernels: True (cuEq path; no build) | | CUTLASS_PATH ... not set ... cutlass_library is not installed | cuEq path still needs the python cutlass_library shim | pip install nvidia-cutlass | | libXrender.so.1: cannot open shared object file | rdkit (via pdbeccdutils) needs X11 render libs | apt-get install libxrender1 libxext6 libsm6 | | ModuleNotFoundError: boto3 (or awscrt) | openfold3.core.data.io.s3 is eager-imported even when weights are local | pip install boto3 awscrt | | ValidationError: queries / Field required or Input should be an object | wrong JSON shape | top-level is {"queries": {"<name>": {...}}} (a dict, not a list) | | ValidationError ... settings / Extra inputs are not permitted | tried to override model config via --runner-yaml | --runner-yaml is InferenceExperimentConfig only; kernel/memory settings live in model_config.py | | Failed to fetch chain ID mappings from RCSB for N entries | data.rcsb.org unreachable (allowlist/offline) | run with --use-templates false, or open egress to data.rcsb.org | | CUDA out of memory | large complex / many samples | reduce --num-diffusion-samples; the low_mem preset (model_setting_presets.yml) offloads more aggressively |

Related Skills

View on GitHub
GitHub Stars4.9k
CategoryDevelopment
Updated1mo ago
Forks294

Languages

TypeScript

Trust signals

100/100

From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.

No cautions