fold
Submits and manages FastFold protein folding jobs via the Jobs API. Covers authentication, creating jobs, polling for completion, and fetching CIF/PDB URLs, metrics, and viewer links. Use when folding protein sequences with FastFold, calling the FastFold API, or scripting fold-and-wait workflows.
Install via CLI (Recommended)
clawhub install openclaw/skills/skills/juliocesar-io/fastfold-ai-foldFold
Overview
This skill guides correct use of the FastFold Jobs API: create fold jobs, wait for completion with polling, then fetch results (CIF/PDB URLs, metrics, viewer link). Use the bundled OpenAPI schema and scripts in this skill for consistent behavior (skill is self-contained).
Authentication
Get an API key: Create a key in the FastFold dashboard. Keep it secret; anyone with the key can make requests on your behalf.
Use the key: Scripts read FASTFOLD_API_KEY from local .env or environment.
Do not ask users to paste secrets in chat.
.envfile (recommended): Scripts automatically loadFASTFOLD_API_KEYfrom a.envfile in the project (current dir or any parent). Do not commit.env.- Environment:
export FASTFOLD_API_KEY="sk-..."(overrides.envif both set). - Credential policy: Never request, accept, echo, or store API keys in chat messages, command history, or logs.
Agent — when the user needs to set the API key: If FASTFOLD_API_KEY is not set:
- Copy the template for the user: Copy
skills/fold/references/.env.exampleto.envat the workspace (project) root. Create the.envfile yourself (e.g. read the example file and write its contents to.env); do not ask the user to run the copy command. - Guide the user: Tell the user that a
.envfile has been created and they need to add their key. Say: "Open the.envfile in the project root and paste your FastFold API key after the=on the lineFASTFOLD_API_KEY=. You can create a key at FastFold API Keys if you don’t have one. Save the file when done." - Offer to run the workflow: Add: "Let me know when you’ve pasted your key—I can run the create job and the rest of the steps (wait for completion, fetch results, download CIF, viewer link) for you." Do not give the user a list of commands to run themselves; offer to execute the scripts yourself once the key is set.
- Wait: Do not run create job, wait, fetch, or download until the user confirms they have pasted and saved the key. After they confirm, run the scripts from the workspace root using the path
skills/fold/scripts/(e.g.python skills/fold/scripts/create_job.py ...), not.agents/....
Required before any authenticated action: If FASTFOLD_API_KEY is not set, follow the Agent steps above (create .env from references/.env.example, then ask the user to paste the key locally and confirm). Only proceed with jobs after the key is set.
Public jobs (isPublic: true) can be read without auth via Get Job Results; private jobs require the owner’s API key. See references/auth_and_api.md for details and quota limits.
When to Use This Skill
Metadata
Not sure this is the right skill?
Describe what you want to build — we'll match you to the best skill from 16,000+ options.
Find the right skillPaste this into your clawhub.json to enable this plugin.
{
"plugins": {
"official-juliocesar-io-fastfold-ai-fold": {
"enabled": true,
"auto_update": true
}
}
}