fastfold-fold-job

Submit FastFold fold jobs via the Jobs API and fetch CIF/PDB URLs.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/fastfold-ai/agent-skills --skill fastfold-fold-job
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: fastfold-fold-job
Source: https://github.com/fastfold-ai/agent-skills/tree/main/skills/fastfold-fold-job
Command: npx skills add https://github.com/fastfold-ai/agent-skills --skill fastfold-fold-job

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires requests, and includes scripts (resource) and references (resource) components.

What problem does it solve?

Submits and manages FastFold protein folding jobs via the Jobs API, handling authentication, job creation, polling for completion, and retrieval of CIF/PDB URLs, metrics, and viewer links.

Core Features & Use Cases

  • End-to-end workflow: create a fold job, monitor progress, and fetch results and viewer links for quick inspection.
  • Flexible inputs: supports single-protein sequences and multi-sequence payloads with optional constraints and multiple models.
  • Reusable automation: designed for scripting fold-and-wait workflows in AI coding assistants.

Quick Start

Create a FastFold fold job for your protein sequence, wait for completion, and retrieve CIF/PDB URLs and the viewer link.

Frequently Asked Questions about fastfold-fold-job

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate a protein folding job from start to finish?

You can automate a protein folding job by using scripts to submit a sequence via the Jobs API, poll for completion, and fetch the resulting CIF and PDB URLs. This handles authentication, job creation, waiting, and retrieval in one workflow.

What is the best way to retrieve a 3D viewer link after a protein folding job completes?

The best way to retrieve a 3D viewer link is to poll the Jobs API until the folding job completes, then fetch the viewer link from the returned results. The workflow provides the viewer URL alongside the CIF and PDB file URLs and metrics.

Can I submit multiple protein sequences in a single fold job request?

Yes, you can submit multiple protein sequences in a single fold job request. The workflow supports multi-sequence payloads with optional constraints and multiple models, allowing batch processing of protein folding jobs through the API.

Do I need an API key to submit a fold job?

Yes, you need a supported API key to submit a fold job. The workflow uses the API key for authentication when creating jobs, polling for completion, and fetching the resulting CIF and PDB URLs and metrics from the Jobs API.

What file formats are supported when fetching protein folding results?

The workflow supports fetching results in both CIF and PDB file formats. After the protein folding job completes, the API returns URLs for both formats, along with the job metrics and a 3D viewer link for quick inspection.

How do I handle errors when polling a protein folding job for completion?

Polling for protein folding job completion relies on the Jobs API status updates. The bundled scripts and OpenAPI schema define the create, wait, and fetch steps, allowing you to monitor progress and handle completion or failure states during the automation workflow.