[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill-openai-boltz-small-molecule-screen":3,"mdc-pgaizx-key":36,"related-repo-openai-boltz-small-molecule-screen":1292,"related-org-openai-boltz-small-molecule-screen":1415},{"slug":4,"name":4,"fn":5,"description":6,"org":7,"tags":11,"stars":25,"repoUrl":26,"updatedAt":27,"license":28,"forks":29,"topics":30,"repo":31,"sourceUrl":34,"mdContent":35},"boltz-small-molecule-screen","screen small-molecule libraries with Boltz","Screen existing small-molecule libraries with Boltz. Use when docking, scoring, or ranking a supplied SMILES or compound library against a target; also returns free Tier-1 ADME\u002FADMET (solubility, permeability, lipophilicity\u002FlogD) per molecule. Not for de novo molecule design, one-off docking, or ADME on bare SMILES with no target (use boltz-small-molecule-adme).",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},"openai","OpenAI","https:\u002F\u002Fpexgzepcugksgbtrxkhf.supabase.co\u002Fstorage\u002Fv1\u002Fobject\u002Fpublic\u002Forg-logos\u002Fopenai.png",[12,16,19,22],{"name":13,"slug":14,"type":15},"Research","research","tag",{"name":17,"slug":18,"type":15},"Life Sciences","life-sciences",{"name":20,"slug":21,"type":15},"Bioinformatics","bioinformatics",{"name":23,"slug":24,"type":15},"Chemistry","chemistry",3992,"https:\u002F\u002Fgithub.com\u002Fopenai\u002Fplugins","2026-06-30T19:00:57.102",null,465,[],{"repoUrl":26,"stars":25,"forks":29,"topics":32,"description":33},[],"OpenAI Plugins","https:\u002F\u002Fgithub.com\u002Fopenai\u002Fplugins\u002Ftree\u002FHEAD\u002Fplugins\u002Fboltz-api-cli\u002Fskills\u002Fboltz-small-molecule-screen","---\nname: boltz-small-molecule-screen\ndescription: Screen existing small-molecule libraries with Boltz. Use when docking, scoring, or ranking a supplied SMILES or compound library against a target; also returns free Tier-1 ADME\u002FADMET (solubility, permeability, lipophilicity\u002FlogD) per molecule. Not for de novo molecule design, one-off docking, or ADME on bare SMILES with no target (use boltz-small-molecule-adme).\n---\n\n## Workflow\n\nIf `boltz-api` is missing from `PATH`, use `boltz-cli-setup` for install\u002Fupdate guidance before retrying.\nIf a command reports missing or expired authentication, use `boltz-cli-setup` to start `boltz-api auth login --device-code` before retrying; do not ask permission first.\nIf the agent host sandbox blocks `boltz-api` install\u002Fauth\u002FAPI calls, use `boltz-cli-setup` to request the host sandbox bypass\u002Fescalation needed for user-wide CLI install, browser login, credential storage, temp files, or API access before retrying.\n\nUse this skill when the user already has candidate molecules.\n\n1. Normalize the library from raw SMILES, a CSV (auto-detect the SMILES column), `.smi`, or `.txt` into the `molecules` list. Each entry is `{smiles, id?}`; the optional `id` is echoed back as `external_id` on each result.\n2. Normalize the target: one or more protein sequences into `target.entities`, plus optional `pocket_residues` (0-based) and\u002For `reference_ligands` (SMILES of known binders to help locate the pocket).\n3. Keep default server-side filtering unless the user asks for custom filters — only add `molecule_filters` on explicit request.\n4. Author the payload YAML or JSON, run `estimate-cost`, show the USD cost, wait for explicit confirmation.\n5. `start` to submit (synchronous). Capture the ID.\n6. Launch `download-results` with the agent runtime's background\u002Fnon-blocking command facility — it polls, paginates `list-results`, downloads every per-hit structure, and exits when terminal. In Claude Code, use Bash with `run_in_background: true`. In Codex, run `download-results` as a foreground shell command with `yield_time_ms: 1000`; if Codex returns a `session_id`, keep it for optional same-thread polling, but treat `download-status` plus the run directory as the durable source of truth. In Codex app\u002Fdesktop runtimes that expose same-thread heartbeat automations, create a heartbeat that checks `download-status` periodically and posts a concise completion or failure update when the download reaches a terminal state. After launching the downloader, always report the job ID, run name, and output directory. Include the next check cadence if the heartbeat was created; otherwise include the `download-status` command.\n7. When done, rank from `\u003Coutput-root>\u002F\u003Crun-name>\u002Fresults\u002Findex.jsonl`. Sort by `binding_confidence` for hit discovery or `optimization_score` for lead optimization; these are parallel intents, not a fallback hierarchy. Report the top 5-10 hits with `smiles`, the chosen ranking metric, key confidence metrics, and structure path. Each result also carries a free `adme` block (`solubility`, `permeability`, `lipophilicity`) — include it for developability triage when the user cares about ADME, or when a top hit looks risky. Read [references\u002Fresults.md](references\u002Fresults.md) for output layout, metrics, ADME, and filtered-input accounting.\n\n## Command Pattern\n\n```bash\n# Replace placeholders with concrete absolute paths before running.\n# Use a short descriptive run name, for example: sm-screen-\u003Ctarget>-\u003Clibrary>-v1\n\nboltz-api small-molecule:library-screen estimate-cost \\\n  --input @yaml:\u002F\u002F\u002Fabsolute\u002Fpath\u002Fpayload.yaml\n\nboltz-api small-molecule:library-screen start \\\n       --idempotency-key \"\u003Crun-name>\" \\\n       --input @yaml:\u002F\u002F\u002Fabsolute\u002Fpath\u002Fpayload.yaml \\\n       --raw-output --transform id\n\n# Copy the printed job ID into this command, then launch it in the agent\n# runtime's background\u002Fnon-blocking mode.\n# Claude Code: Bash with run_in_background=true.\n# Codex: foreground shell command with yield_time_ms=1000; keep the returned session_id if one is provided.\n# Do not append \"&\" or use nohup in Codex.\nboltz-api download-results \\\n  --id \"\u003Cjob-id-from-start>\" --name \"\u003Crun-name>\" \\\n  --root-dir \"\u002Fabsolute\u002Fpath\u002Fboltz-experiments\" \\\n  --poll-interval-seconds 30\n# -> \u002Fabsolute\u002Fpath\u002Fboltz-experiments\u002F\u003Crun-name>\u002Fresults\u002F\u003Cpres_*>\u002F...\n```\n\nPayload keys are `molecules`, `target`, `molecule_filters` — the API body field names, not the direct CLI flag names `--molecule` \u002F `--target` \u002F `--molecule-filters`.\n\n## Always Do This\n\n- Keep payload field names exactly as the API body names shown in `references\u002Fapi.md`.\n- Use absolute paths for the output root, payload files, and embedded target files. Do not `cd` into the run directory for follow-up commands; pass the same `--root-dir` and use absolute paths so later relative paths do not drift.\n- Prefer one merged top-level payload via `--input @yaml:\u002F\u002F\u002Fabsolute\u002Fpath\u002Fpayload.yaml` or `@json:\u002F\u002F\u002Fabsolute\u002Fpath\u002Fpayload.json` for `estimate-cost` and `start`. Keep `--idempotency-key` and `--workspace-id` top-level; if they also appear inside `--input`, the top-level flags win.\n- Direct object flags still work as overrides, such as `--target @yaml:\u002F\u002F\u002Fabsolute\u002Fpath\u002Ftarget.yaml`, `--molecule-filters @json:\u002F\u002F\u002Fabsolute\u002Fpath\u002Ffilters.json`, or repeated `--molecule @json:\u002F\u002F\u002Fabsolute\u002Fpath\u002Fmol-1.json` entries. Piped YAML \u002F JSON on stdin also works, but it must use API body field names. Never use `@file:\u002F\u002F` or `@.\u002F`.\n- Treat pocket residue indices as 0-based.\n- Do not invent medicinal-chemistry filters. Only add `molecule_filters` if the user asks; mention the catalog as an option.\n- Use the same slug as both `--idempotency-key` at submit and `--name` on `download-results` so re-runs resume via `.boltz-run.json`.\n- In permission-gated agents such as Claude Code, keep each Boltz call as a top-level command that starts with `boltz-api`. Prefer concrete arguments over `sh -c`, inline environment assignments, aliases, wrapper scripts, loops, or pipelines around the `boltz-api` invocation unless the user already allowed that exact command form. Use `--raw-output --transform id`, read the printed ID, then paste that literal ID into the next `download-results` command.\n- Prefer the agent runtime's background\u002Fnon-blocking command mode for `download-results`. In Codex specifically, keep `download-results` in the foreground and set the shell tool yield to 1000 ms; Codex will return a `session_id` if the command is still running. Do not append `&` or use `nohup` in Codex because the tool runner may clean up shell-backgrounded descendants before `.boltz-run.json` is fully written.\n- After the background\u002Fsession starts, do not manually wait on it or run ad hoc polling loops. `download-results` emits JSONL progress on stderr by default; add `--progress-format text --verbose` only when you explicitly want human-readable logs.\n- In Codex app\u002Fdesktop runtimes with same-thread heartbeat automation support, schedule a heartbeat after launching `download-results`. The heartbeat should run `boltz-api --format json download-status --name \"\u003Crun-name>\" --root-dir \"\u002Fabsolute\u002Fpath\u002Fboltz-experiments\"` and stop once terminal. Choose cadence by molecule count: under 100 -> every 1-2 minutes; 100-1,000 -> every 5 minutes; over 1,000 -> every 15 minutes. Post only material status changes or terminal completion\u002Ffailure. Poll the saved `session_id` with an empty `write_stdin` only for interactive, user-requested progress checks. Never run a manual poll loop in the current turn.\n- If the current host has no heartbeat automation support, do not claim an automatic next check. Report the job ID, run name, output directory, and the command needed to check `download-status`.\n- If detached download needs to be restarted, re-run `boltz-api download-results` with the same `--name \"\u003Crun-name>\"` and the same `--root-dir`.\n- Cost is a flat $0.025 per molecule (size-independent). `estimate-cost` returns the authoritative total — always use it.\n- Poll interval: `--poll-interval-seconds 30` is a reasonable downloader default. Wall-clock time scales roughly with the number of molecules: under 100 often finishes in a few minutes, 100-1,000 may take several minutes to tens of minutes, and larger screens can take longer or hours depending on inputs and system load. Don't quote a fixed duration, and never tell the user a 10-candidate screen will take 30 minutes or hours.\n\n## Escape Hatch\n\n- Payload reference: \u003Chttps:\u002F\u002Fapi.boltz.bio\u002Fdocs\u002Fapi\u002Fpython\u002Fresources\u002Fsmall_molecule\u002Fsubresources\u002Flibrary_screen\u002Fmethods\u002Fstart>\n- CLI flag names: `boltz-api small-molecule:library-screen start --help`\n\nRead [references\u002Fapi.md](references\u002Fapi.md) for the `molecules`, `target`, and `molecule_filters` shapes, including the built-in SMARTS filters and RDKit descriptor ranges. Read [references\u002Fresults.md](references\u002Fresults.md) after download when ranking hits or explaining missing\u002Ffiltered inputs.\n\n## Outputs\n\nRank from `results\u002Findex.jsonl` after `download-results`; use [references\u002Fresults.md](references\u002Fresults.md) for the local file layout, metric meanings, and filtered-input accounting.\n",{"data":37,"body":38},{"name":4,"description":6},{"type":39,"children":40},"root",[41,50,110,115,389,395,735,783,789,1185,1191,1217,1254,1260,1286],{"type":42,"tag":43,"props":44,"children":46},"element","h2",{"id":45},"workflow",[47],{"type":48,"value":49},"text","Workflow",{"type":42,"tag":51,"props":52,"children":53},"p",{},[54,56,63,65,71,73,79,81,86,88,94,96,101,103,108],{"type":48,"value":55},"If ",{"type":42,"tag":57,"props":58,"children":60},"code",{"className":59},[],[61],{"type":48,"value":62},"boltz-api",{"type":48,"value":64}," is missing from ",{"type":42,"tag":57,"props":66,"children":68},{"className":67},[],[69],{"type":48,"value":70},"PATH",{"type":48,"value":72},", use ",{"type":42,"tag":57,"props":74,"children":76},{"className":75},[],[77],{"type":48,"value":78},"boltz-cli-setup",{"type":48,"value":80}," for install\u002Fupdate guidance before retrying.\nIf a command reports missing or expired authentication, use ",{"type":42,"tag":57,"props":82,"children":84},{"className":83},[],[85],{"type":48,"value":78},{"type":48,"value":87}," to start ",{"type":42,"tag":57,"props":89,"children":91},{"className":90},[],[92],{"type":48,"value":93},"boltz-api auth login --device-code",{"type":48,"value":95}," before retrying; do not ask permission first.\nIf the agent host sandbox blocks ",{"type":42,"tag":57,"props":97,"children":99},{"className":98},[],[100],{"type":48,"value":62},{"type":48,"value":102}," install\u002Fauth\u002FAPI calls, use ",{"type":42,"tag":57,"props":104,"children":106},{"className":105},[],[107],{"type":48,"value":78},{"type":48,"value":109}," to request the host sandbox bypass\u002Fescalation needed for user-wide CLI install, browser login, credential storage, temp files, or API access before retrying.",{"type":42,"tag":51,"props":111,"children":112},{},[113],{"type":48,"value":114},"Use this skill when the user already has candidate molecules.",{"type":42,"tag":116,"props":117,"children":118},"ol",{},[119,173,202,215,228,239,313],{"type":42,"tag":120,"props":121,"children":122},"li",{},[123,125,131,133,139,141,147,149,155,157,163,165,171],{"type":48,"value":124},"Normalize the library from raw SMILES, a CSV (auto-detect the SMILES column), ",{"type":42,"tag":57,"props":126,"children":128},{"className":127},[],[129],{"type":48,"value":130},".smi",{"type":48,"value":132},", or ",{"type":42,"tag":57,"props":134,"children":136},{"className":135},[],[137],{"type":48,"value":138},".txt",{"type":48,"value":140}," into the ",{"type":42,"tag":57,"props":142,"children":144},{"className":143},[],[145],{"type":48,"value":146},"molecules",{"type":48,"value":148}," list. Each entry is ",{"type":42,"tag":57,"props":150,"children":152},{"className":151},[],[153],{"type":48,"value":154},"{smiles, id?}",{"type":48,"value":156},"; the optional ",{"type":42,"tag":57,"props":158,"children":160},{"className":159},[],[161],{"type":48,"value":162},"id",{"type":48,"value":164}," is echoed back as ",{"type":42,"tag":57,"props":166,"children":168},{"className":167},[],[169],{"type":48,"value":170},"external_id",{"type":48,"value":172}," on each result.",{"type":42,"tag":120,"props":174,"children":175},{},[176,178,184,186,192,194,200],{"type":48,"value":177},"Normalize the target: one or more protein sequences into ",{"type":42,"tag":57,"props":179,"children":181},{"className":180},[],[182],{"type":48,"value":183},"target.entities",{"type":48,"value":185},", plus optional ",{"type":42,"tag":57,"props":187,"children":189},{"className":188},[],[190],{"type":48,"value":191},"pocket_residues",{"type":48,"value":193}," (0-based) and\u002For ",{"type":42,"tag":57,"props":195,"children":197},{"className":196},[],[198],{"type":48,"value":199},"reference_ligands",{"type":48,"value":201}," (SMILES of known binders to help locate the pocket).",{"type":42,"tag":120,"props":203,"children":204},{},[205,207,213],{"type":48,"value":206},"Keep default server-side filtering unless the user asks for custom filters — only add ",{"type":42,"tag":57,"props":208,"children":210},{"className":209},[],[211],{"type":48,"value":212},"molecule_filters",{"type":48,"value":214}," on explicit request.",{"type":42,"tag":120,"props":216,"children":217},{},[218,220,226],{"type":48,"value":219},"Author the payload YAML or JSON, run ",{"type":42,"tag":57,"props":221,"children":223},{"className":222},[],[224],{"type":48,"value":225},"estimate-cost",{"type":48,"value":227},", show the USD cost, wait for explicit confirmation.",{"type":42,"tag":120,"props":229,"children":230},{},[231,237],{"type":42,"tag":57,"props":232,"children":234},{"className":233},[],[235],{"type":48,"value":236},"start",{"type":48,"value":238}," to submit (synchronous). Capture the ID.",{"type":42,"tag":120,"props":240,"children":241},{},[242,244,250,252,258,260,266,268,273,275,281,283,289,291,297,299,304,306,311],{"type":48,"value":243},"Launch ",{"type":42,"tag":57,"props":245,"children":247},{"className":246},[],[248],{"type":48,"value":249},"download-results",{"type":48,"value":251}," with the agent runtime's background\u002Fnon-blocking command facility — it polls, paginates ",{"type":42,"tag":57,"props":253,"children":255},{"className":254},[],[256],{"type":48,"value":257},"list-results",{"type":48,"value":259},", downloads every per-hit structure, and exits when terminal. In Claude Code, use Bash with ",{"type":42,"tag":57,"props":261,"children":263},{"className":262},[],[264],{"type":48,"value":265},"run_in_background: true",{"type":48,"value":267},". In Codex, run ",{"type":42,"tag":57,"props":269,"children":271},{"className":270},[],[272],{"type":48,"value":249},{"type":48,"value":274}," as a foreground shell command with ",{"type":42,"tag":57,"props":276,"children":278},{"className":277},[],[279],{"type":48,"value":280},"yield_time_ms: 1000",{"type":48,"value":282},"; if Codex returns a ",{"type":42,"tag":57,"props":284,"children":286},{"className":285},[],[287],{"type":48,"value":288},"session_id",{"type":48,"value":290},", keep it for optional same-thread polling, but treat ",{"type":42,"tag":57,"props":292,"children":294},{"className":293},[],[295],{"type":48,"value":296},"download-status",{"type":48,"value":298}," plus the run directory as the durable source of truth. In Codex app\u002Fdesktop runtimes that expose same-thread heartbeat automations, create a heartbeat that checks ",{"type":42,"tag":57,"props":300,"children":302},{"className":301},[],[303],{"type":48,"value":296},{"type":48,"value":305}," periodically and posts a concise completion or failure update when the download reaches a terminal state. After launching the downloader, always report the job ID, run name, and output directory. Include the next check cadence if the heartbeat was created; otherwise include the ",{"type":42,"tag":57,"props":307,"children":309},{"className":308},[],[310],{"type":48,"value":296},{"type":48,"value":312}," command.",{"type":42,"tag":120,"props":314,"children":315},{},[316,318,324,326,332,334,340,342,348,350,356,358,364,366,372,373,379,381,387],{"type":48,"value":317},"When done, rank from ",{"type":42,"tag":57,"props":319,"children":321},{"className":320},[],[322],{"type":48,"value":323},"\u003Coutput-root>\u002F\u003Crun-name>\u002Fresults\u002Findex.jsonl",{"type":48,"value":325},". Sort by ",{"type":42,"tag":57,"props":327,"children":329},{"className":328},[],[330],{"type":48,"value":331},"binding_confidence",{"type":48,"value":333}," for hit discovery or ",{"type":42,"tag":57,"props":335,"children":337},{"className":336},[],[338],{"type":48,"value":339},"optimization_score",{"type":48,"value":341}," for lead optimization; these are parallel intents, not a fallback hierarchy. Report the top 5-10 hits with ",{"type":42,"tag":57,"props":343,"children":345},{"className":344},[],[346],{"type":48,"value":347},"smiles",{"type":48,"value":349},", the chosen ranking metric, key confidence metrics, and structure path. Each result also carries a free ",{"type":42,"tag":57,"props":351,"children":353},{"className":352},[],[354],{"type":48,"value":355},"adme",{"type":48,"value":357}," block (",{"type":42,"tag":57,"props":359,"children":361},{"className":360},[],[362],{"type":48,"value":363},"solubility",{"type":48,"value":365},", ",{"type":42,"tag":57,"props":367,"children":369},{"className":368},[],[370],{"type":48,"value":371},"permeability",{"type":48,"value":365},{"type":42,"tag":57,"props":374,"children":376},{"className":375},[],[377],{"type":48,"value":378},"lipophilicity",{"type":48,"value":380},") — include it for developability triage when the user cares about ADME, or when a top hit looks risky. Read ",{"type":42,"tag":382,"props":383,"children":385},"a",{"href":384},"references\u002Fresults.md",[386],{"type":48,"value":384},{"type":48,"value":388}," for output layout, metrics, ADME, and filtered-input accounting.",{"type":42,"tag":43,"props":390,"children":392},{"id":391},"command-pattern",[393],{"type":48,"value":394},"Command Pattern",{"type":42,"tag":396,"props":397,"children":402},"pre",{"className":398,"code":399,"language":400,"meta":401,"style":401},"language-bash shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","# Replace placeholders with concrete absolute paths before running.\n# Use a short descriptive run name, for example: sm-screen-\u003Ctarget>-\u003Clibrary>-v1\n\nboltz-api small-molecule:library-screen estimate-cost \\\n  --input @yaml:\u002F\u002F\u002Fabsolute\u002Fpath\u002Fpayload.yaml\n\nboltz-api small-molecule:library-screen start \\\n       --idempotency-key \"\u003Crun-name>\" \\\n       --input @yaml:\u002F\u002F\u002Fabsolute\u002Fpath\u002Fpayload.yaml \\\n       --raw-output --transform id\n\n# Copy the printed job ID into this command, then launch it in the agent\n# runtime's background\u002Fnon-blocking mode.\n# Claude Code: Bash with run_in_background=true.\n# Codex: foreground shell command with yield_time_ms=1000; keep the returned session_id if one is provided.\n# Do not append \"&\" or use nohup in Codex.\nboltz-api download-results \\\n  --id \"\u003Cjob-id-from-start>\" --name \"\u003Crun-name>\" \\\n  --root-dir \"\u002Fabsolute\u002Fpath\u002Fboltz-experiments\" \\\n  --poll-interval-seconds 30\n# -> \u002Fabsolute\u002Fpath\u002Fboltz-experiments\u002F\u003Crun-name>\u002Fresults\u002F\u003Cpres_*>\u002F...\n","bash","",[403],{"type":42,"tag":57,"props":404,"children":405},{"__ignoreMap":401},[406,418,427,437,463,477,485,506,535,553,572,580,589,598,607,616,625,642,685,711,726],{"type":42,"tag":407,"props":408,"children":411},"span",{"class":409,"line":410},"line",1,[412],{"type":42,"tag":407,"props":413,"children":415},{"style":414},"--shiki-light:#90A4AE;--shiki-light-font-style:italic;--shiki-default:#546E7A;--shiki-default-font-style:italic;--shiki-dark:#676E95;--shiki-dark-font-style:italic",[416],{"type":48,"value":417},"# Replace placeholders with concrete absolute paths before running.\n",{"type":42,"tag":407,"props":419,"children":421},{"class":409,"line":420},2,[422],{"type":42,"tag":407,"props":423,"children":424},{"style":414},[425],{"type":48,"value":426},"# Use a short descriptive run name, for example: sm-screen-\u003Ctarget>-\u003Clibrary>-v1\n",{"type":42,"tag":407,"props":428,"children":430},{"class":409,"line":429},3,[431],{"type":42,"tag":407,"props":432,"children":434},{"emptyLinePlaceholder":433},true,[435],{"type":48,"value":436},"\n",{"type":42,"tag":407,"props":438,"children":440},{"class":409,"line":439},4,[441,446,452,457],{"type":42,"tag":407,"props":442,"children":444},{"style":443},"--shiki-light:#E2931D;--shiki-default:#FFCB6B;--shiki-dark:#FFCB6B",[445],{"type":48,"value":62},{"type":42,"tag":407,"props":447,"children":449},{"style":448},"--shiki-light:#91B859;--shiki-default:#C3E88D;--shiki-dark:#C3E88D",[450],{"type":48,"value":451}," small-molecule:library-screen",{"type":42,"tag":407,"props":453,"children":454},{"style":448},[455],{"type":48,"value":456}," estimate-cost",{"type":42,"tag":407,"props":458,"children":460},{"style":459},"--shiki-light:#90A4AE;--shiki-default:#EEFFFF;--shiki-dark:#BABED8",[461],{"type":48,"value":462}," \\\n",{"type":42,"tag":407,"props":464,"children":466},{"class":409,"line":465},5,[467,472],{"type":42,"tag":407,"props":468,"children":469},{"style":448},[470],{"type":48,"value":471},"  --input",{"type":42,"tag":407,"props":473,"children":474},{"style":448},[475],{"type":48,"value":476}," @yaml:\u002F\u002F\u002Fabsolute\u002Fpath\u002Fpayload.yaml\n",{"type":42,"tag":407,"props":478,"children":480},{"class":409,"line":479},6,[481],{"type":42,"tag":407,"props":482,"children":483},{"emptyLinePlaceholder":433},[484],{"type":48,"value":436},{"type":42,"tag":407,"props":486,"children":488},{"class":409,"line":487},7,[489,493,497,502],{"type":42,"tag":407,"props":490,"children":491},{"style":443},[492],{"type":48,"value":62},{"type":42,"tag":407,"props":494,"children":495},{"style":448},[496],{"type":48,"value":451},{"type":42,"tag":407,"props":498,"children":499},{"style":448},[500],{"type":48,"value":501}," start",{"type":42,"tag":407,"props":503,"children":504},{"style":459},[505],{"type":48,"value":462},{"type":42,"tag":407,"props":507,"children":509},{"class":409,"line":508},8,[510,515,521,526,531],{"type":42,"tag":407,"props":511,"children":512},{"style":448},[513],{"type":48,"value":514},"       --idempotency-key",{"type":42,"tag":407,"props":516,"children":518},{"style":517},"--shiki-light:#39ADB5;--shiki-default:#89DDFF;--shiki-dark:#89DDFF",[519],{"type":48,"value":520}," \"",{"type":42,"tag":407,"props":522,"children":523},{"style":448},[524],{"type":48,"value":525},"\u003Crun-name>",{"type":42,"tag":407,"props":527,"children":528},{"style":517},[529],{"type":48,"value":530},"\"",{"type":42,"tag":407,"props":532,"children":533},{"style":459},[534],{"type":48,"value":462},{"type":42,"tag":407,"props":536,"children":538},{"class":409,"line":537},9,[539,544,549],{"type":42,"tag":407,"props":540,"children":541},{"style":448},[542],{"type":48,"value":543},"       --input",{"type":42,"tag":407,"props":545,"children":546},{"style":448},[547],{"type":48,"value":548}," @yaml:\u002F\u002F\u002Fabsolute\u002Fpath\u002Fpayload.yaml",{"type":42,"tag":407,"props":550,"children":551},{"style":459},[552],{"type":48,"value":462},{"type":42,"tag":407,"props":554,"children":556},{"class":409,"line":555},10,[557,562,567],{"type":42,"tag":407,"props":558,"children":559},{"style":448},[560],{"type":48,"value":561},"       --raw-output",{"type":42,"tag":407,"props":563,"children":564},{"style":448},[565],{"type":48,"value":566}," --transform",{"type":42,"tag":407,"props":568,"children":569},{"style":448},[570],{"type":48,"value":571}," id\n",{"type":42,"tag":407,"props":573,"children":575},{"class":409,"line":574},11,[576],{"type":42,"tag":407,"props":577,"children":578},{"emptyLinePlaceholder":433},[579],{"type":48,"value":436},{"type":42,"tag":407,"props":581,"children":583},{"class":409,"line":582},12,[584],{"type":42,"tag":407,"props":585,"children":586},{"style":414},[587],{"type":48,"value":588},"# Copy the printed job ID into this command, then launch it in the agent\n",{"type":42,"tag":407,"props":590,"children":592},{"class":409,"line":591},13,[593],{"type":42,"tag":407,"props":594,"children":595},{"style":414},[596],{"type":48,"value":597},"# runtime's background\u002Fnon-blocking mode.\n",{"type":42,"tag":407,"props":599,"children":601},{"class":409,"line":600},14,[602],{"type":42,"tag":407,"props":603,"children":604},{"style":414},[605],{"type":48,"value":606},"# Claude Code: Bash with run_in_background=true.\n",{"type":42,"tag":407,"props":608,"children":610},{"class":409,"line":609},15,[611],{"type":42,"tag":407,"props":612,"children":613},{"style":414},[614],{"type":48,"value":615},"# Codex: foreground shell command with yield_time_ms=1000; keep the returned session_id if one is provided.\n",{"type":42,"tag":407,"props":617,"children":619},{"class":409,"line":618},16,[620],{"type":42,"tag":407,"props":621,"children":622},{"style":414},[623],{"type":48,"value":624},"# Do not append \"&\" or use nohup in Codex.\n",{"type":42,"tag":407,"props":626,"children":628},{"class":409,"line":627},17,[629,633,638],{"type":42,"tag":407,"props":630,"children":631},{"style":443},[632],{"type":48,"value":62},{"type":42,"tag":407,"props":634,"children":635},{"style":448},[636],{"type":48,"value":637}," download-results",{"type":42,"tag":407,"props":639,"children":640},{"style":459},[641],{"type":48,"value":462},{"type":42,"tag":407,"props":643,"children":645},{"class":409,"line":644},18,[646,651,655,660,664,669,673,677,681],{"type":42,"tag":407,"props":647,"children":648},{"style":448},[649],{"type":48,"value":650},"  --id",{"type":42,"tag":407,"props":652,"children":653},{"style":517},[654],{"type":48,"value":520},{"type":42,"tag":407,"props":656,"children":657},{"style":448},[658],{"type":48,"value":659},"\u003Cjob-id-from-start>",{"type":42,"tag":407,"props":661,"children":662},{"style":517},[663],{"type":48,"value":530},{"type":42,"tag":407,"props":665,"children":666},{"style":448},[667],{"type":48,"value":668}," --name",{"type":42,"tag":407,"props":670,"children":671},{"style":517},[672],{"type":48,"value":520},{"type":42,"tag":407,"props":674,"children":675},{"style":448},[676],{"type":48,"value":525},{"type":42,"tag":407,"props":678,"children":679},{"style":517},[680],{"type":48,"value":530},{"type":42,"tag":407,"props":682,"children":683},{"style":459},[684],{"type":48,"value":462},{"type":42,"tag":407,"props":686,"children":688},{"class":409,"line":687},19,[689,694,698,703,707],{"type":42,"tag":407,"props":690,"children":691},{"style":448},[692],{"type":48,"value":693},"  --root-dir",{"type":42,"tag":407,"props":695,"children":696},{"style":517},[697],{"type":48,"value":520},{"type":42,"tag":407,"props":699,"children":700},{"style":448},[701],{"type":48,"value":702},"\u002Fabsolute\u002Fpath\u002Fboltz-experiments",{"type":42,"tag":407,"props":704,"children":705},{"style":517},[706],{"type":48,"value":530},{"type":42,"tag":407,"props":708,"children":709},{"style":459},[710],{"type":48,"value":462},{"type":42,"tag":407,"props":712,"children":714},{"class":409,"line":713},20,[715,720],{"type":42,"tag":407,"props":716,"children":717},{"style":448},[718],{"type":48,"value":719},"  --poll-interval-seconds",{"type":42,"tag":407,"props":721,"children":723},{"style":722},"--shiki-light:#F76D47;--shiki-default:#F78C6C;--shiki-dark:#F78C6C",[724],{"type":48,"value":725}," 30\n",{"type":42,"tag":407,"props":727,"children":729},{"class":409,"line":728},21,[730],{"type":42,"tag":407,"props":731,"children":732},{"style":414},[733],{"type":48,"value":734},"# -> \u002Fabsolute\u002Fpath\u002Fboltz-experiments\u002F\u003Crun-name>\u002Fresults\u002F\u003Cpres_*>\u002F...\n",{"type":42,"tag":51,"props":736,"children":737},{},[738,740,745,746,752,753,758,760,766,768,774,775,781],{"type":48,"value":739},"Payload keys are ",{"type":42,"tag":57,"props":741,"children":743},{"className":742},[],[744],{"type":48,"value":146},{"type":48,"value":365},{"type":42,"tag":57,"props":747,"children":749},{"className":748},[],[750],{"type":48,"value":751},"target",{"type":48,"value":365},{"type":42,"tag":57,"props":754,"children":756},{"className":755},[],[757],{"type":48,"value":212},{"type":48,"value":759}," — the API body field names, not the direct CLI flag names ",{"type":42,"tag":57,"props":761,"children":763},{"className":762},[],[764],{"type":48,"value":765},"--molecule",{"type":48,"value":767}," \u002F ",{"type":42,"tag":57,"props":769,"children":771},{"className":770},[],[772],{"type":48,"value":773},"--target",{"type":48,"value":767},{"type":42,"tag":57,"props":776,"children":778},{"className":777},[],[779],{"type":48,"value":780},"--molecule-filters",{"type":48,"value":782},".",{"type":42,"tag":43,"props":784,"children":786},{"id":785},"always-do-this",[787],{"type":48,"value":788},"Always Do This",{"type":42,"tag":790,"props":791,"children":792},"ul",{},[793,805,826,884,926,931,943,977,1018,1067,1087,1122,1133,1160,1172],{"type":42,"tag":120,"props":794,"children":795},{},[796,798,804],{"type":48,"value":797},"Keep payload field names exactly as the API body names shown in ",{"type":42,"tag":57,"props":799,"children":801},{"className":800},[],[802],{"type":48,"value":803},"references\u002Fapi.md",{"type":48,"value":782},{"type":42,"tag":120,"props":806,"children":807},{},[808,810,816,818,824],{"type":48,"value":809},"Use absolute paths for the output root, payload files, and embedded target files. Do not ",{"type":42,"tag":57,"props":811,"children":813},{"className":812},[],[814],{"type":48,"value":815},"cd",{"type":48,"value":817}," into the run directory for follow-up commands; pass the same ",{"type":42,"tag":57,"props":819,"children":821},{"className":820},[],[822],{"type":48,"value":823},"--root-dir",{"type":48,"value":825}," and use absolute paths so later relative paths do not drift.",{"type":42,"tag":120,"props":827,"children":828},{},[829,831,837,839,845,847,852,854,859,861,867,868,874,876,882],{"type":48,"value":830},"Prefer one merged top-level payload via ",{"type":42,"tag":57,"props":832,"children":834},{"className":833},[],[835],{"type":48,"value":836},"--input @yaml:\u002F\u002F\u002Fabsolute\u002Fpath\u002Fpayload.yaml",{"type":48,"value":838}," or ",{"type":42,"tag":57,"props":840,"children":842},{"className":841},[],[843],{"type":48,"value":844},"@json:\u002F\u002F\u002Fabsolute\u002Fpath\u002Fpayload.json",{"type":48,"value":846}," for ",{"type":42,"tag":57,"props":848,"children":850},{"className":849},[],[851],{"type":48,"value":225},{"type":48,"value":853}," and ",{"type":42,"tag":57,"props":855,"children":857},{"className":856},[],[858],{"type":48,"value":236},{"type":48,"value":860},". Keep ",{"type":42,"tag":57,"props":862,"children":864},{"className":863},[],[865],{"type":48,"value":866},"--idempotency-key",{"type":48,"value":853},{"type":42,"tag":57,"props":869,"children":871},{"className":870},[],[872],{"type":48,"value":873},"--workspace-id",{"type":48,"value":875}," top-level; if they also appear inside ",{"type":42,"tag":57,"props":877,"children":879},{"className":878},[],[880],{"type":48,"value":881},"--input",{"type":48,"value":883},", the top-level flags win.",{"type":42,"tag":120,"props":885,"children":886},{},[887,889,895,896,902,904,910,912,918,919,925],{"type":48,"value":888},"Direct object flags still work as overrides, such as ",{"type":42,"tag":57,"props":890,"children":892},{"className":891},[],[893],{"type":48,"value":894},"--target @yaml:\u002F\u002F\u002Fabsolute\u002Fpath\u002Ftarget.yaml",{"type":48,"value":365},{"type":42,"tag":57,"props":897,"children":899},{"className":898},[],[900],{"type":48,"value":901},"--molecule-filters @json:\u002F\u002F\u002Fabsolute\u002Fpath\u002Ffilters.json",{"type":48,"value":903},", or repeated ",{"type":42,"tag":57,"props":905,"children":907},{"className":906},[],[908],{"type":48,"value":909},"--molecule @json:\u002F\u002F\u002Fabsolute\u002Fpath\u002Fmol-1.json",{"type":48,"value":911}," entries. Piped YAML \u002F JSON on stdin also works, but it must use API body field names. Never use ",{"type":42,"tag":57,"props":913,"children":915},{"className":914},[],[916],{"type":48,"value":917},"@file:\u002F\u002F",{"type":48,"value":838},{"type":42,"tag":57,"props":920,"children":922},{"className":921},[],[923],{"type":48,"value":924},"@.\u002F",{"type":48,"value":782},{"type":42,"tag":120,"props":927,"children":928},{},[929],{"type":48,"value":930},"Treat pocket residue indices as 0-based.",{"type":42,"tag":120,"props":932,"children":933},{},[934,936,941],{"type":48,"value":935},"Do not invent medicinal-chemistry filters. Only add ",{"type":42,"tag":57,"props":937,"children":939},{"className":938},[],[940],{"type":48,"value":212},{"type":48,"value":942}," if the user asks; mention the catalog as an option.",{"type":42,"tag":120,"props":944,"children":945},{},[946,948,953,955,961,963,968,970,976],{"type":48,"value":947},"Use the same slug as both ",{"type":42,"tag":57,"props":949,"children":951},{"className":950},[],[952],{"type":48,"value":866},{"type":48,"value":954}," at submit and ",{"type":42,"tag":57,"props":956,"children":958},{"className":957},[],[959],{"type":48,"value":960},"--name",{"type":48,"value":962}," on ",{"type":42,"tag":57,"props":964,"children":966},{"className":965},[],[967],{"type":48,"value":249},{"type":48,"value":969}," so re-runs resume via ",{"type":42,"tag":57,"props":971,"children":973},{"className":972},[],[974],{"type":48,"value":975},".boltz-run.json",{"type":48,"value":782},{"type":42,"tag":120,"props":978,"children":979},{},[980,982,987,989,995,997,1002,1004,1010,1012,1017],{"type":48,"value":981},"In permission-gated agents such as Claude Code, keep each Boltz call as a top-level command that starts with ",{"type":42,"tag":57,"props":983,"children":985},{"className":984},[],[986],{"type":48,"value":62},{"type":48,"value":988},". Prefer concrete arguments over ",{"type":42,"tag":57,"props":990,"children":992},{"className":991},[],[993],{"type":48,"value":994},"sh -c",{"type":48,"value":996},", inline environment assignments, aliases, wrapper scripts, loops, or pipelines around the ",{"type":42,"tag":57,"props":998,"children":1000},{"className":999},[],[1001],{"type":48,"value":62},{"type":48,"value":1003}," invocation unless the user already allowed that exact command form. Use ",{"type":42,"tag":57,"props":1005,"children":1007},{"className":1006},[],[1008],{"type":48,"value":1009},"--raw-output --transform id",{"type":48,"value":1011},", read the printed ID, then paste that literal ID into the next ",{"type":42,"tag":57,"props":1013,"children":1015},{"className":1014},[],[1016],{"type":48,"value":249},{"type":48,"value":312},{"type":42,"tag":120,"props":1019,"children":1020},{},[1021,1023,1028,1030,1035,1037,1042,1044,1050,1052,1058,1060,1065],{"type":48,"value":1022},"Prefer the agent runtime's background\u002Fnon-blocking command mode for ",{"type":42,"tag":57,"props":1024,"children":1026},{"className":1025},[],[1027],{"type":48,"value":249},{"type":48,"value":1029},". In Codex specifically, keep ",{"type":42,"tag":57,"props":1031,"children":1033},{"className":1032},[],[1034],{"type":48,"value":249},{"type":48,"value":1036}," in the foreground and set the shell tool yield to 1000 ms; Codex will return a ",{"type":42,"tag":57,"props":1038,"children":1040},{"className":1039},[],[1041],{"type":48,"value":288},{"type":48,"value":1043}," if the command is still running. Do not append ",{"type":42,"tag":57,"props":1045,"children":1047},{"className":1046},[],[1048],{"type":48,"value":1049},"&",{"type":48,"value":1051}," or use ",{"type":42,"tag":57,"props":1053,"children":1055},{"className":1054},[],[1056],{"type":48,"value":1057},"nohup",{"type":48,"value":1059}," in Codex because the tool runner may clean up shell-backgrounded descendants before ",{"type":42,"tag":57,"props":1061,"children":1063},{"className":1062},[],[1064],{"type":48,"value":975},{"type":48,"value":1066}," is fully written.",{"type":42,"tag":120,"props":1068,"children":1069},{},[1070,1072,1077,1079,1085],{"type":48,"value":1071},"After the background\u002Fsession starts, do not manually wait on it or run ad hoc polling loops. ",{"type":42,"tag":57,"props":1073,"children":1075},{"className":1074},[],[1076],{"type":48,"value":249},{"type":48,"value":1078}," emits JSONL progress on stderr by default; add ",{"type":42,"tag":57,"props":1080,"children":1082},{"className":1081},[],[1083],{"type":48,"value":1084},"--progress-format text --verbose",{"type":48,"value":1086}," only when you explicitly want human-readable logs.",{"type":42,"tag":120,"props":1088,"children":1089},{},[1090,1092,1097,1099,1105,1107,1112,1114,1120],{"type":48,"value":1091},"In Codex app\u002Fdesktop runtimes with same-thread heartbeat automation support, schedule a heartbeat after launching ",{"type":42,"tag":57,"props":1093,"children":1095},{"className":1094},[],[1096],{"type":48,"value":249},{"type":48,"value":1098},". The heartbeat should run ",{"type":42,"tag":57,"props":1100,"children":1102},{"className":1101},[],[1103],{"type":48,"value":1104},"boltz-api --format json download-status --name \"\u003Crun-name>\" --root-dir \"\u002Fabsolute\u002Fpath\u002Fboltz-experiments\"",{"type":48,"value":1106}," and stop once terminal. Choose cadence by molecule count: under 100 -> every 1-2 minutes; 100-1,000 -> every 5 minutes; over 1,000 -> every 15 minutes. Post only material status changes or terminal completion\u002Ffailure. Poll the saved ",{"type":42,"tag":57,"props":1108,"children":1110},{"className":1109},[],[1111],{"type":48,"value":288},{"type":48,"value":1113}," with an empty ",{"type":42,"tag":57,"props":1115,"children":1117},{"className":1116},[],[1118],{"type":48,"value":1119},"write_stdin",{"type":48,"value":1121}," only for interactive, user-requested progress checks. Never run a manual poll loop in the current turn.",{"type":42,"tag":120,"props":1123,"children":1124},{},[1125,1127,1132],{"type":48,"value":1126},"If the current host has no heartbeat automation support, do not claim an automatic next check. Report the job ID, run name, output directory, and the command needed to check ",{"type":42,"tag":57,"props":1128,"children":1130},{"className":1129},[],[1131],{"type":48,"value":296},{"type":48,"value":782},{"type":42,"tag":120,"props":1134,"children":1135},{},[1136,1138,1144,1146,1152,1154,1159],{"type":48,"value":1137},"If detached download needs to be restarted, re-run ",{"type":42,"tag":57,"props":1139,"children":1141},{"className":1140},[],[1142],{"type":48,"value":1143},"boltz-api download-results",{"type":48,"value":1145}," with the same ",{"type":42,"tag":57,"props":1147,"children":1149},{"className":1148},[],[1150],{"type":48,"value":1151},"--name \"\u003Crun-name>\"",{"type":48,"value":1153}," and the same ",{"type":42,"tag":57,"props":1155,"children":1157},{"className":1156},[],[1158],{"type":48,"value":823},{"type":48,"value":782},{"type":42,"tag":120,"props":1161,"children":1162},{},[1163,1165,1170],{"type":48,"value":1164},"Cost is a flat $0.025 per molecule (size-independent). ",{"type":42,"tag":57,"props":1166,"children":1168},{"className":1167},[],[1169],{"type":48,"value":225},{"type":48,"value":1171}," returns the authoritative total — always use it.",{"type":42,"tag":120,"props":1173,"children":1174},{},[1175,1177,1183],{"type":48,"value":1176},"Poll interval: ",{"type":42,"tag":57,"props":1178,"children":1180},{"className":1179},[],[1181],{"type":48,"value":1182},"--poll-interval-seconds 30",{"type":48,"value":1184}," is a reasonable downloader default. Wall-clock time scales roughly with the number of molecules: under 100 often finishes in a few minutes, 100-1,000 may take several minutes to tens of minutes, and larger screens can take longer or hours depending on inputs and system load. Don't quote a fixed duration, and never tell the user a 10-candidate screen will take 30 minutes or hours.",{"type":42,"tag":43,"props":1186,"children":1188},{"id":1187},"escape-hatch",[1189],{"type":48,"value":1190},"Escape Hatch",{"type":42,"tag":790,"props":1192,"children":1193},{},[1194,1206],{"type":42,"tag":120,"props":1195,"children":1196},{},[1197,1199],{"type":48,"value":1198},"Payload reference: ",{"type":42,"tag":382,"props":1200,"children":1204},{"href":1201,"rel":1202},"https:\u002F\u002Fapi.boltz.bio\u002Fdocs\u002Fapi\u002Fpython\u002Fresources\u002Fsmall_molecule\u002Fsubresources\u002Flibrary_screen\u002Fmethods\u002Fstart",[1203],"nofollow",[1205],{"type":48,"value":1201},{"type":42,"tag":120,"props":1207,"children":1208},{},[1209,1211],{"type":48,"value":1210},"CLI flag names: ",{"type":42,"tag":57,"props":1212,"children":1214},{"className":1213},[],[1215],{"type":48,"value":1216},"boltz-api small-molecule:library-screen start --help",{"type":42,"tag":51,"props":1218,"children":1219},{},[1220,1222,1226,1228,1233,1234,1239,1241,1246,1248,1252],{"type":48,"value":1221},"Read ",{"type":42,"tag":382,"props":1223,"children":1224},{"href":803},[1225],{"type":48,"value":803},{"type":48,"value":1227}," for the ",{"type":42,"tag":57,"props":1229,"children":1231},{"className":1230},[],[1232],{"type":48,"value":146},{"type":48,"value":365},{"type":42,"tag":57,"props":1235,"children":1237},{"className":1236},[],[1238],{"type":48,"value":751},{"type":48,"value":1240},", and ",{"type":42,"tag":57,"props":1242,"children":1244},{"className":1243},[],[1245],{"type":48,"value":212},{"type":48,"value":1247}," shapes, including the built-in SMARTS filters and RDKit descriptor ranges. Read ",{"type":42,"tag":382,"props":1249,"children":1250},{"href":384},[1251],{"type":48,"value":384},{"type":48,"value":1253}," after download when ranking hits or explaining missing\u002Ffiltered inputs.",{"type":42,"tag":43,"props":1255,"children":1257},{"id":1256},"outputs",[1258],{"type":48,"value":1259},"Outputs",{"type":42,"tag":51,"props":1261,"children":1262},{},[1263,1265,1271,1273,1278,1280,1284],{"type":48,"value":1264},"Rank from ",{"type":42,"tag":57,"props":1266,"children":1268},{"className":1267},[],[1269],{"type":48,"value":1270},"results\u002Findex.jsonl",{"type":48,"value":1272}," after ",{"type":42,"tag":57,"props":1274,"children":1276},{"className":1275},[],[1277],{"type":48,"value":249},{"type":48,"value":1279},"; use ",{"type":42,"tag":382,"props":1281,"children":1282},{"href":384},[1283],{"type":48,"value":384},{"type":48,"value":1285}," for the local file layout, metric meanings, and filtered-input accounting.",{"type":42,"tag":1287,"props":1288,"children":1289},"style",{},[1290],{"type":48,"value":1291},"html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}",{"items":1293,"total":1414},[1294,1312,1328,1340,1360,1382,1402],{"slug":1295,"name":1295,"fn":1296,"description":1297,"org":1298,"tags":1299,"stars":25,"repoUrl":26,"updatedAt":27},"accessibility-and-inclusive-visualization","make data visualizations accessible","Make data visualizations accessible and inclusive. Use when the user needs chart or diagram accessibility guidance, text alternatives for complex visuals, color and contrast review, keyboard support, reduced-motion behavior for animation or parallax, or an accessibility QA workflow for exported figures, UML-like diagrams, and dashboards.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1300,1303,1306,1309],{"name":1301,"slug":1302,"type":15},"Accessibility","accessibility",{"name":1304,"slug":1305,"type":15},"Charts","charts",{"name":1307,"slug":1308,"type":15},"Data Visualization","data-visualization",{"name":1310,"slug":1311,"type":15},"Design","design",{"slug":1313,"name":1313,"fn":1314,"description":1315,"org":1316,"tags":1317,"stars":25,"repoUrl":26,"updatedAt":1327},"agent-browser","automate browser interactions for agents","Browser automation CLI for AI agents. Use when the user needs to interact with websites, verify dev server output, test web apps, navigate pages, fill forms, click buttons, take screenshots, extract data, or automate any browser task. Also triggers when a dev server starts so you can verify it visually.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1318,1321,1324],{"name":1319,"slug":1320,"type":15},"Agents","agents",{"name":1322,"slug":1323,"type":15},"Browser Automation","browser-automation",{"name":1325,"slug":1326,"type":15},"Testing","testing","2026-04-06T18:41:03.44016",{"slug":1329,"name":1329,"fn":1330,"description":1331,"org":1332,"tags":1333,"stars":25,"repoUrl":26,"updatedAt":1339},"agent-browser-verify","verify dev server output with automated browser","Automated browser verification for dev servers. Triggers when a dev server starts to run a visual gut-check with agent-browser — verifies the page loads, checks for console errors, validates key UI elements, and reports pass\u002Ffail before continuing.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1334,1335,1338],{"name":1322,"slug":1323,"type":15},{"name":1336,"slug":1337,"type":15},"Local Development","local-development",{"name":1325,"slug":1326,"type":15},"2026-04-06T18:41:17.526867",{"slug":1341,"name":1341,"fn":1342,"description":1343,"org":1344,"tags":1345,"stars":25,"repoUrl":26,"updatedAt":1359},"agents-sdk","build AI agents on Cloudflare Workers","Build AI agents on Cloudflare Workers using the Agents SDK. Load when creating stateful agents, durable workflows, real-time WebSocket apps, scheduled tasks, MCP servers, or chat applications. Covers Agent class, state management, callable RPC, Workflows integration, and React hooks. Biases towards retrieval from Cloudflare docs over pre-trained knowledge.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1346,1347,1350,1353,1356],{"name":1319,"slug":1320,"type":15},{"name":1348,"slug":1349,"type":15},"Cloudflare Workers","cloudflare-workers",{"name":1351,"slug":1352,"type":15},"SDK","sdk",{"name":1354,"slug":1355,"type":15},"Serverless","serverless",{"name":1357,"slug":1358,"type":15},"WebSockets","websockets","2026-04-06T18:39:51.717063",{"slug":1361,"name":1361,"fn":1362,"description":1363,"org":1364,"tags":1365,"stars":25,"repoUrl":26,"updatedAt":1381},"ai-elements","build chat UIs with AI Elements","AI Elements component library guidance — pre-built React components for AI interfaces built on shadcn\u002Fui. Use when building chat UIs, message displays, tool call rendering, streaming responses, reasoning panels, or any AI-native interface with the AI SDK.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1366,1369,1372,1375,1378],{"name":1367,"slug":1368,"type":15},"Frontend","frontend",{"name":1370,"slug":1371,"type":15},"React","react",{"name":1373,"slug":1374,"type":15},"shadcn\u002Fui","shadcn-ui",{"name":1376,"slug":1377,"type":15},"UI Components","ui-components",{"name":1379,"slug":1380,"type":15},"Vercel","vercel","2026-04-06T18:40:59.619419",{"slug":1383,"name":1383,"fn":1384,"description":1385,"org":1386,"tags":1387,"stars":25,"repoUrl":26,"updatedAt":1401},"ai-gateway","configure Vercel AI Gateway","Vercel AI Gateway expert guidance. Use when configuring model routing, provider failover, cost tracking, or managing multiple AI providers through a unified API.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1388,1391,1394,1397,1400],{"name":1389,"slug":1390,"type":15},"AI Infrastructure","ai-infrastructure",{"name":1392,"slug":1393,"type":15},"Cost Optimization","cost-optimization",{"name":1395,"slug":1396,"type":15},"LLM","llm",{"name":1398,"slug":1399,"type":15},"Performance","performance",{"name":1379,"slug":1380,"type":15},"2026-04-06T18:40:44.377464",{"slug":1403,"name":1403,"fn":1404,"description":1405,"org":1406,"tags":1407,"stars":25,"repoUrl":26,"updatedAt":1413},"ai-generation-persistence","implement persistence patterns for AI generations","AI generation persistence patterns — unique IDs, addressable URLs, database storage, and cost tracking for every LLM generation",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1408,1409,1412],{"name":1392,"slug":1393,"type":15},{"name":1410,"slug":1411,"type":15},"Database","database",{"name":1395,"slug":1396,"type":15},"2026-04-06T18:41:08.513425",600,{"items":1416,"total":1613},[1417,1438,1461,1478,1494,1511,1530,1542,1556,1570,1582,1597],{"slug":1418,"name":1418,"fn":1419,"description":1420,"org":1421,"tags":1422,"stars":1435,"repoUrl":1436,"updatedAt":1437},"prior-auth-packet-builder","build healthcare prior authorization packets","Build a concise prior authorization packet from local case files and payer policy docs.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1423,1426,1429,1432],{"name":1424,"slug":1425,"type":15},"Documents","documents",{"name":1427,"slug":1428,"type":15},"Healthcare","healthcare",{"name":1430,"slug":1431,"type":15},"Insurance","insurance",{"name":1433,"slug":1434,"type":15},"Regulatory Compliance","regulatory-compliance",28169,"https:\u002F\u002Fgithub.com\u002Fopenai\u002Fopenai-agents-python","2026-04-16T05:11:39.180399",{"slug":1439,"name":1439,"fn":1440,"description":1441,"org":1442,"tags":1443,"stars":1458,"repoUrl":1459,"updatedAt":1460},"aspnet-core","build ASP.NET Core web applications","Build, review, refactor, or architect ASP.NET Core web applications using current official guidance for .NET web development. Use when working on Blazor Web Apps, Razor Pages, MVC, Minimal APIs, controller-based Web APIs, SignalR, gRPC, middleware, dependency injection, configuration, authentication, authorization, testing, performance, deployment, or ASP.NET Core upgrades.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1444,1447,1449,1452,1455],{"name":1445,"slug":1446,"type":15},".NET","dotnet",{"name":1448,"slug":1439,"type":15},"ASP.NET Core",{"name":1450,"slug":1451,"type":15},"Blazor","blazor",{"name":1453,"slug":1454,"type":15},"C#","csharp",{"name":1456,"slug":1457,"type":15},"Web Development","web-development",23787,"https:\u002F\u002Fgithub.com\u002Fopenai\u002Fskills","2026-04-12T05:07:02.819491",{"slug":1462,"name":1462,"fn":1463,"description":1464,"org":1465,"tags":1466,"stars":1458,"repoUrl":1459,"updatedAt":1477},"chatgpt-apps","build ChatGPT Apps SDK applications","Build, scaffold, refactor, and troubleshoot ChatGPT Apps SDK applications that combine an MCP server and widget UI. Use when Codex needs to design tools, register UI resources, wire the MCP Apps bridge or ChatGPT compatibility APIs, apply Apps SDK metadata or CSP or domain settings, or produce a docs-aligned project scaffold. Prefer a docs-first workflow by invoking the openai-docs skill or OpenAI developer docs MCP tools before generating code.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1467,1470,1473,1476],{"name":1468,"slug":1469,"type":15},"Apps SDK","apps-sdk",{"name":1471,"slug":1472,"type":15},"ChatGPT","chatgpt",{"name":1474,"slug":1475,"type":15},"MCP","mcp",{"name":9,"slug":8,"type":15},"2026-04-12T05:07:05.468097",{"slug":1479,"name":1479,"fn":1480,"description":1481,"org":1482,"tags":1483,"stars":1458,"repoUrl":1459,"updatedAt":1493},"cli-creator","build CLIs from API docs","Build a composable CLI for Codex from API docs, an OpenAPI spec, existing curl examples, an SDK, a web app, an admin tool, or a local script. Use when the user wants Codex to create a command-line tool that can run from any repo, expose composable read\u002Fwrite commands, return stable JSON, manage auth, and pair with a companion skill.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1484,1487,1490],{"name":1485,"slug":1486,"type":15},"API Development","api-development",{"name":1488,"slug":1489,"type":15},"CLI","cli",{"name":1491,"slug":1492,"type":15},"Codex","codex","2026-04-12T05:07:04.132762",{"slug":1495,"name":1495,"fn":1496,"description":1497,"org":1498,"tags":1499,"stars":1458,"repoUrl":1459,"updatedAt":1510},"cloudflare-deploy","deploy projects to Cloudflare","Deploy applications and infrastructure to Cloudflare using Workers, Pages, and related platform services. Use when the user asks to deploy, host, publish, or set up a project on Cloudflare.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1500,1503,1506,1507],{"name":1501,"slug":1502,"type":15},"Cloudflare","cloudflare",{"name":1504,"slug":1505,"type":15},"Cloudflare Pages","cloudflare-pages",{"name":1348,"slug":1349,"type":15},{"name":1508,"slug":1509,"type":15},"Deployment","deployment","2026-04-12T05:07:14.275118",{"slug":1512,"name":1512,"fn":1513,"description":1514,"org":1515,"tags":1516,"stars":1458,"repoUrl":1459,"updatedAt":1529},"define-goal","define and set measurable project goals","Help the user define a concrete, measurable goal before starting work, especially when they ask to use the goal tool, create a goal, set an objective, clarify success criteria, or turn a fuzzy intention into a quantitative outcome. Use this skill for goal creation and goal refinement only; it does not manage durable snapshots, decision logs, or long-running execution artifacts.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1517,1520,1523,1526],{"name":1518,"slug":1519,"type":15},"Productivity","productivity",{"name":1521,"slug":1522,"type":15},"Project Management","project-management",{"name":1524,"slug":1525,"type":15},"Strategy","strategy",{"name":1527,"slug":1528,"type":15},"Task Management","task-management","2026-05-23T06:17:16.870838",{"slug":1531,"name":1531,"fn":1532,"description":1533,"org":1534,"tags":1535,"stars":1458,"repoUrl":1459,"updatedAt":1541},"figma","translate Figma designs into code","Use the Figma MCP server to fetch design context, screenshots, variables, and assets from Figma, and to translate Figma nodes into production code. Trigger when a task involves Figma URLs, node IDs, design-to-code implementation, or Figma MCP setup and troubleshooting.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1536,1537,1539,1540],{"name":1310,"slug":1311,"type":15},{"name":1538,"slug":1531,"type":15},"Figma",{"name":1367,"slug":1368,"type":15},{"name":1474,"slug":1475,"type":15},"2026-04-12T05:06:47.939943",{"slug":1543,"name":1543,"fn":1544,"description":1545,"org":1546,"tags":1547,"stars":1458,"repoUrl":1459,"updatedAt":1555},"figma-code-connect-components","connect Figma designs to code components","Connects Figma design components to code components using Code Connect mapping tools. Use when user says \"code connect\", \"connect this component to code\", \"map this component\", \"link component to code\", \"create code connect mapping\", or wants to establish mappings between Figma designs and code implementations. For canvas writes via `use_figma`, use `figma-use`.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1548,1549,1552,1553,1554],{"name":1310,"slug":1311,"type":15},{"name":1550,"slug":1551,"type":15},"Design System","design-system",{"name":1538,"slug":1531,"type":15},{"name":1367,"slug":1368,"type":15},{"name":1376,"slug":1377,"type":15},"2026-05-10T05:59:52.971881",{"slug":1557,"name":1557,"fn":1558,"description":1559,"org":1560,"tags":1561,"stars":1458,"repoUrl":1459,"updatedAt":1569},"figma-create-design-system-rules","generate design system rules from Figma","Generates custom design system rules for the user's codebase. Use when user says \"create design system rules\", \"generate rules for my project\", \"set up design rules\", \"customize design system guidelines\", or wants to establish project-specific conventions for Figma-to-code workflows. Requires Figma MCP server connection.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1562,1563,1564,1567,1568],{"name":1310,"slug":1311,"type":15},{"name":1550,"slug":1551,"type":15},{"name":1565,"slug":1566,"type":15},"Documentation","documentation",{"name":1538,"slug":1531,"type":15},{"name":1367,"slug":1368,"type":15},"2026-05-16T06:07:47.821474",{"slug":1571,"name":1571,"fn":1572,"description":1573,"org":1574,"tags":1575,"stars":1458,"repoUrl":1459,"updatedAt":1581},"figma-implement-design","translate Figma designs into application code","Translates Figma designs into production-ready application code with 1:1 visual fidelity. Use when implementing UI code from Figma files, when user mentions \"implement design\", \"generate code\", \"implement component\", provides Figma URLs, or asks to build components matching Figma specs. For Figma canvas writes via `use_figma`, use `figma-use`.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1576,1577,1578,1579,1580],{"name":1310,"slug":1311,"type":15},{"name":1538,"slug":1531,"type":15},{"name":1367,"slug":1368,"type":15},{"name":1376,"slug":1377,"type":15},{"name":1456,"slug":1457,"type":15},"2026-05-16T06:07:40.583615",{"slug":1583,"name":1583,"fn":1584,"description":1585,"org":1586,"tags":1587,"stars":1458,"repoUrl":1459,"updatedAt":1596},"hatch-pet","create animated pets for Codex","Create, repair, validate, visually QA, and package Codex-compatible animated pets and pet spritesheets from character art, generated images, company or prospect brand cues, or visual references. Use when a user wants a lightweight-worker Codex pet workflow, a non-pixel custom pet style, a prospect or company mascot pet, or a full 8x9 animated pet atlas with transparent unused cells, QA contact sheets, and pet.json packaging. This skill composes the installed $imagegen system skill for visual generation and uses bundled scripts for deterministic spritesheet assembly.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1588,1591,1592,1595],{"name":1589,"slug":1590,"type":15},"Animation","animation",{"name":1491,"slug":1492,"type":15},{"name":1593,"slug":1594,"type":15},"Creative","creative",{"name":1310,"slug":1311,"type":15},"2026-05-02T05:31:48.48485",{"slug":1598,"name":1598,"fn":1599,"description":1600,"org":1601,"tags":1602,"stars":1458,"repoUrl":1459,"updatedAt":1612},"imagegen","generate and edit raster images","Generate or edit raster images when the task benefits from AI-created bitmap visuals such as photos, illustrations, textures, sprites, mockups, or transparent-background cutouts. Use when Codex should create a brand-new image, transform an existing image, or derive visual variants from references, and the output should be a bitmap asset rather than repo-native code or vector. Do not use when the task is better handled by editing existing SVG\u002Fvector\u002Fcode-native assets, extending an established icon or logo system, or building the visual directly in HTML\u002FCSS\u002Fcanvas.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1603,1604,1605,1608,1611],{"name":1593,"slug":1594,"type":15},{"name":1310,"slug":1311,"type":15},{"name":1606,"slug":1607,"type":15},"Image Generation","image-generation",{"name":1609,"slug":1610,"type":15},"Images","images",{"name":9,"slug":8,"type":15},"2026-05-15T06:23:24.312127",675]