convez.ai
SkillIntegração & APIsAvançado
boltz-bio

Boltz Skills para Agentes de IA

boltz-bio/boltz-api-skills

Execute workflows de biologia computacional via agentes de IA

Ver no GitHub
BomPluginScore · de 0 a 100

Conjunto de skills Python que integram workflows de biologia molecular (previsão de estrutura, binding, screening e design de proteínas/moléculas) diretamente em agentes de IA como Claude Code e Gemini CLI. Os skills encapsulam a CLI boltz-api, permitindo que o agente submeta jobs, estime custos e baixe resultados automaticamente.

Instalação

$npx convez-ai boltz-bio/boltz-api-skills

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
5
Forks
1
Acompanhando
0
Saúde
62%
Último commit
há 2 dias
Versão
codex-plugin/v0.1.1
Issues abertas
11
Contribuidores
8

Casos de uso

  • Previsão de estrutura 3D e scoring de binding de complexos proteicos
  • Screening de bibliotecas de moléculas pequenas contra targets
  • Design de novo de peptídeos, anticorpos e proteínas binders
  • Estimativa de propriedades ADME de moléculas

Veredito

Skill especializada e bem-estruturada para pesquisadores em biologia computacional. Exige CLI boltz-api instalada e autenticada, representando solução profissional para automação de workflows complexos em química e biologia molecular através de agentes de IA.

README

A tradução para o português deste README ainda está na fila.

Boltz Skills

Run Boltz biomolecular workflows — structure prediction, binding, molecular and protein screening, and de novo design — directly from your AI coding agent. The skills shell out to the boltz-api CLI to create inputs, estimate cost, submit jobs, and download results.

📖 Full guide: Agent integrations for the Boltz API

Supported agents

For Codex and Claude Code, use the official marketplace plugins. Gemini CLI has a native extension, and Claude Desktop uses the MCPB server. Vercel Skills provides an additional way to install the shared skills in Antigravity and other supported agents, or in environments where you prefer a direct skill installation.

Skills

SkillWhat it does
boltz-cli-setupInstall, update, verify, and authenticate the boltz-api CLI.
boltz-structure-and-bindingPredict the 3D structure of a defined complex; optionally score binding.
boltz-small-molecule-screenRank a SMILES library against a target.
boltz-small-molecule-designGenerate novel small-molecule binders.
boltz-small-molecule-admeEstimate Tier-1 ADME (solubility, permeability, logD) from bare SMILES.
boltz-protein-screenRank proteins / peptides / antibodies against a target.
boltz-protein-designGenerate novel peptide / antibody / nanobody / custom-protein binders.
boltz-check-statusList and inspect jobs; recover results after an interrupted session.

Prerequisites

All surfaces need the boltz-api CLI on your PATH.

macOS and Linux:

curl -fsSL https://install.boltz.bio/boltz-api/install.sh | sh

Windows PowerShell:

irm https://install.boltz.bio/boltz-api/install.ps1 | iex

Verify it:

boltz-api --version

Then authenticate, using either device-code login or an API key:

boltz-api auth login --device-code
# or
export BOLTZ_API_KEY="your-api-key"

Results download to a boltz-experiments/ directory in your working directory (created automatically). Point any command at a different location with --root-dir.

Install

Codex and Claude Code (recommended: official plugins)

For Codex, open the plugin directory, search for Boltz, and install the official plugin. In Codex CLI, enter /plugins to open the plugin browser. Start a new session after installing. See the Codex installation guide for details.

For Claude Code, follow the marketplace installation guide.

Both plugins use boltz-api; complete the prerequisites above or ask for boltz-cli-setup.

Other agents and direct skill installation

Use Vercel Skills with Node.js 22.20 or newer. Select your agents and skills interactively:

npx skills add boltz-bio/boltz-api-skills

For example, install all eight skills for Gemini CLI in the current project:

npx skills add boltz-bio/boltz-api-skills --skill '*' --agent gemini-cli

Add --global to make the skills available across projects. Use --list to preview the available skills without installing. Use --copy if your host cannot use symlinks. Skills installation does not install or authenticate the boltz-api CLI; complete the prerequisites above or ask for boltz-cli-setup.

Use one installation method per agent and scope to avoid loading the same skills twice. Direct Skills installation is optional for Codex and Claude Code; existing marketplace users can keep their plugin installation.

To install selected skills, pass their names to --skill. Include boltz-cli-setup if you need help installing or authenticating the CLI:

npx skills add boltz-bio/boltz-api-skills --skill boltz-cli-setup boltz-protein-design --agent gemini-cli

For direct Skills installations, keep the generated skills-lock.json with your project. Updates are explicit; review the resulting file changes:

npx skills update boltz-cli-setup boltz-protein-design --project

Use your agent's plugin manager to update marketplace installations.

Gemini extension

Gemini CLI users can also use the native extension.

Claude Desktop

Download the latest boltz-mcpb-<version>.mcpb from Releases and install it via Settings → Extensions → Advanced settings → Install Extension.

Restart your agent after installing.

Usage

Once installed and authenticated, just describe what you want in natural language — the agent picks the right skill, builds the payload, shows you a cost estimate before submitting, and downloads results when the job finishes. For example:

Predict the structure of this protein–ligand complex and score the binding affinity.

Screen these 200 SMILES against my target and rank them.

See the full guide for detailed workflows and examples.

Repository layout

  • skills/<name>/ — canonical public skills with instructions, references, optional helper scripts, and agent metadata.
  • surfaces/ — marketplace and extension wrappers and the Claude Desktop MCPB runtime. CLI wrappers link to skills/; the partner bundle retains its distinct host-managed authentication and spending policy.
  • plugins/ — generated, self-contained marketplace and MCPB copies.
  • tests/ — distribution checks and protein-design helper tests.

Local development

Edit skills/ for shared workflow changes. Then regenerate and verify the marketplace and MCPB packages:

npm ci
scripts/generate-surfaces.sh
npm test
scripts/verify-generated.sh

The install tests use the pinned Skills CLI to install into temporary projects for Claude Code, Codex, and Gemini CLI. They do not install into your agents or submit Boltz jobs.

See CONTRIBUTING.md for runtime tests and release workflows.

License

MIT — see LICENSE.

Ver o original no GitHub

Bom para

Relacionados