diff --git a/development/api-development/sdks.mdx b/development/api-development/sdks.mdx
index b7ad7f273c..06bedc7736 100644
--- a/development/api-development/sdks.mdx
+++ b/development/api-development/sdks.mdx
@@ -47,6 +47,10 @@ Python 3.10 or newer. Node 22 or newer.
+## Using a coding agent
+
+If a coding agent writes a Comfy Router integration, give it the `comfy-sdk` skill. It is written for building on Comfy Router and steers the agent on picking the right client, keeping the API key on the server, discovering a model before calling it, `run` versus `submit`, timeouts, and branching on error buckets. The skill does not cover running ComfyUI workflows. For the workflow client on this page, point the agent at this guide and the [Comfy API v2 reference](/api-reference/v2/overview) instead. In Claude Code, run `/plugin marketplace add Comfy-Org/comfy-skills`, then `/plugin install comfy-sdk@comfy-skills`. For any other agent, copy the single [`SKILL.md`](https://github.com/Comfy-Org/comfy-skills/blob/main/claude-code-sdk/skills/comfy-sdk/SKILL.md) file into your agent's rules, such as `AGENTS.md` or your Cursor rules.
+
## Quickstart
Upload an input image, run a workflow, and write the results to disk.
diff --git a/es/development/api-development/sdks.mdx b/es/development/api-development/sdks.mdx
index 273d018034..53b4ecc6e9 100644
--- a/es/development/api-development/sdks.mdx
+++ b/es/development/api-development/sdks.mdx
@@ -3,11 +3,12 @@ title: "SDK de Comfy: clientes de Python y TypeScript para ComfyUI"
description: "Ejecuta flujos de trabajo de ComfyUI desde Python o TypeScript en Comfy Cloud, tu propio despliegue: recursos, tareas, eventos en vivo y reintentos idempotentes."
sidebarTitle: "SDK"
icon: "code"
-translationSourceHash: fd912955
+translationSourceHash: 918d35f0
translationFrom: development/api-development/sdks.mdx
translationBlockHashes:
"_intro": c92c7b51
"Install": da9a0a57
+ "Using a coding agent": 6540d772
"Quickstart": 02297586
"Choosing a base URL": 0e77e81c
"Retrying a submit: the idempotency key": 7c83d78f
@@ -61,6 +62,10 @@ Python 3.10 o posterior. Node 22 o posterior.
+## Usar un agente de programación
+
+Si un agente de programación escribe una integración con Comfy Router, dale la habilidad `comfy-sdk`. Está escrita para desarrollar sobre Comfy Router y orienta al agente para elegir el cliente correcto, mantener la clave de API en el servidor, descubrir un modelo antes de llamarlo, elegir entre `run` y `submit`, configurar los tiempos de espera y ramificar según la categoría de error. La habilidad no cubre la ejecución de flujos de trabajo de ComfyUI. Para el cliente de flujos de trabajo de esta página, indica al agente que consulte esta guía y la [referencia de Comfy API v2](/es/api-reference/v2/overview). En Claude Code, ejecuta `/plugin marketplace add Comfy-Org/comfy-skills` y después `/plugin install comfy-sdk@comfy-skills`. Para cualquier otro agente, copia el archivo único [`SKILL.md`](https://github.com/Comfy-Org/comfy-skills/blob/main/claude-code-sdk/skills/comfy-sdk/SKILL.md) en las reglas de tu agente, como `AGENTS.md` o tus reglas de Cursor.
+
## Inicio rápido
Sube una imagen de entrada, ejecuta un flujo de trabajo y escribe los resultados en disco.
@@ -142,7 +147,7 @@ const client = new Comfy({ apiKey: "comfyui-..." });
Funciona sin configuración adicional. Crea una [clave API](/es/development/api-development/getting-an-api-key) y pásala al cliente.
- El acceso a la API requiere una suscripción de pago a Comfy Cloud. El plan gratuito no lo incluye. Cuántas tareas puedes ejecutar a la vez depende de tu plan. Consulta [Límites de simultaneidad](/es/development/deploy/cloud-usage#tareas-simultáneas).
+ El acceso a la API requiere una suscripción de pago a Comfy Cloud. El plan gratuito no lo incluye. Cuántas tareas puedes ejecutar a la vez depende de tu plan. Consulta [Límites de simultaneidad](/es/development/deploy/cloud-usage#límites-de-simultaneidad).
diff --git a/ja/development/api-development/sdks.mdx b/ja/development/api-development/sdks.mdx
index 9dc6994459..9fa1e43772 100644
--- a/ja/development/api-development/sdks.mdx
+++ b/ja/development/api-development/sdks.mdx
@@ -3,11 +3,12 @@ title: "Comfy SDK:ComfyUI 向け Python・TypeScript クライアント"
description: "Comfy Cloud、デプロイ環境、または自前の ComfyUI に対して Python または TypeScript から ComfyUI ワークフローを実行し、アセット、ジョブ、ライブイベント、冪等なリトライを扱います。"
sidebarTitle: "SDK"
icon: "code"
-translationSourceHash: fd912955
+translationSourceHash: 918d35f0
translationFrom: development/api-development/sdks.mdx
translationBlockHashes:
"_intro": c92c7b51
"Install": da9a0a57
+ "Using a coding agent": 6540d772
"Quickstart": 02297586
"Choosing a base URL": 0e77e81c
"Retrying a submit: the idempotency key": 7c83d78f
@@ -64,6 +65,10 @@ Python 3.10 以降。Node 22 以降。
+## コーディングエージェントを使う
+
+コーディングエージェントに Comfy Router の連携コードを書かせる場合は、`comfy-sdk` スキルを渡してください。このスキルは Comfy Router 上での開発向けに書かれており、適切なクライアントの選択、API キーをサーバー側に保つこと、呼び出す前にモデルを検出すること、`run` と `submit` の使い分け、タイムアウト、エラーの種別ごとの分岐についてエージェントを導きます。このスキルは ComfyUI ワークフローの実行を扱いません。このページのワークフロークライアントについては、代わりにこのガイドと [Comfy API v2 リファレンス](/ja/api-reference/v2/overview) をエージェントに参照させてください。Claude Code では、`/plugin marketplace add Comfy-Org/comfy-skills` を実行してから `/plugin install comfy-sdk@comfy-skills` を実行します。その他のエージェントでは、単一の [`SKILL.md`](https://github.com/Comfy-Org/comfy-skills/blob/main/claude-code-sdk/skills/comfy-sdk/SKILL.md) ファイルを `AGENTS.md` や Cursor のルールなど、エージェントのルールにコピーしてください。
+
## クイックスタート
入力画像をアップロードし、ワークフローを実行して、結果をディスクに書き込みます。
diff --git a/ko/development/api-development/sdks.mdx b/ko/development/api-development/sdks.mdx
index cf612468d2..022776155a 100644
--- a/ko/development/api-development/sdks.mdx
+++ b/ko/development/api-development/sdks.mdx
@@ -3,11 +3,12 @@ title: "Comfy SDK: ComfyUI용 Python 및 TypeScript 클라이언트"
description: "Python 또는 TypeScript로 Comfy Cloud, 자체 배포 또는 자체 ComfyUI를 대상으로 ComfyUI 워크플로를 실행하고, 에셋, 작업, 라이브 이벤트, 멱등 재시도를 다룹니다."
sidebarTitle: "SDK"
icon: "code"
-translationSourceHash: fd912955
+translationSourceHash: 918d35f0
translationFrom: development/api-development/sdks.mdx
translationBlockHashes:
"_intro": c92c7b51
"Install": da9a0a57
+ "Using a coding agent": 6540d772
"Quickstart": 02297586
"Choosing a base URL": 0e77e81c
"Retrying a submit: the idempotency key": 7c83d78f
@@ -64,6 +65,10 @@ Python 3.10 이상. Node 22 이상.
+## 코딩 에이전트 사용하기
+
+코딩 에이전트가 Comfy Router 통합 코드를 작성한다면 `comfy-sdk` 스킬을 제공하세요. 이 스킬은 Comfy Router 기반 개발을 위해 작성되었으며, 올바른 클라이언트 선택, API 키를 서버에 보관하기, 호출 전에 모델 탐색하기, `run`과 `submit` 중 선택하기, 타임아웃, 오류 유형별 분기 처리에 대해 에이전트를 안내합니다. 이 스킬은 ComfyUI 워크플로 실행을 다루지 않습니다. 이 페이지의 워크플로 클라이언트에 대해서는 대신 이 가이드와 [Comfy API v2 레퍼런스](/ko/api-reference/v2/overview)를 에이전트에게 참고하도록 하세요. Claude Code에서는 `/plugin marketplace add Comfy-Org/comfy-skills`를 실행한 다음 `/plugin install comfy-sdk@comfy-skills`를 실행하세요. 다른 에이전트의 경우 단일 [`SKILL.md`](https://github.com/Comfy-Org/comfy-skills/blob/main/claude-code-sdk/skills/comfy-sdk/SKILL.md) 파일을 `AGENTS.md`나 Cursor 규칙 등 에이전트의 규칙에 복사하세요.
+
## 빠른 시작
입력 이미지를 업로드하고 워크플로를 실행한 다음 결과를 디스크에 기록합니다.
diff --git a/zh/development/api-development/sdks.mdx b/zh/development/api-development/sdks.mdx
index ee5410768b..356c7e9f22 100644
--- a/zh/development/api-development/sdks.mdx
+++ b/zh/development/api-development/sdks.mdx
@@ -3,11 +3,12 @@ title: "Comfy SDK:ComfyUI 的 Python 与 TypeScript 客户端"
description: "用 Python 或 TypeScript 对 Comfy Cloud、自建部署或自有 ComfyUI 运行 ComfyUI 工作流,并处理资产、任务、实时事件和幂等重试。"
sidebarTitle: "SDK"
icon: "code"
-translationSourceHash: fd912955
+translationSourceHash: 918d35f0
translationFrom: development/api-development/sdks.mdx
translationBlockHashes:
"_intro": c92c7b51
"Install": da9a0a57
+ "Using a coding agent": 6540d772
"Quickstart": 02297586
"Choosing a base URL": 0e77e81c
"Retrying a submit: the idempotency key": 7c83d78f
@@ -64,6 +65,10 @@ Python 3.10 或更高版本。Node 22 或更高版本。
+## 使用编码代理
+
+如果由编码代理编写您的 Comfy Router 集成,请为它提供 `comfy-sdk` 技能。该技能面向基于 Comfy Router 的开发,引导代理选择正确的客户端、将 API 密钥保留在服务器端、先发现模型再调用、在 `run` 与 `submit` 之间做出选择、设置超时,以及按错误类别分支处理。该技能不涵盖运行 ComfyUI 工作流。对于本页介绍的工作流客户端,请改为让代理参考本指南和 [Comfy API v2 参考](/zh/api-reference/v2/overview)。在 Claude Code 中,先运行 `/plugin marketplace add Comfy-Org/comfy-skills`,再运行 `/plugin install comfy-sdk@comfy-skills`。对于其他代理,将单个 [`SKILL.md`](https://github.com/Comfy-Org/comfy-skills/blob/main/claude-code-sdk/skills/comfy-sdk/SKILL.md) 文件复制到代理的规则中,例如 `AGENTS.md` 或您的 Cursor 规则。
+
## 快速入门
上传输入图像,运行工作流,并将结果写入磁盘。