Referencia de la API › Recursos
Skills
Crea y mantén instrucciones reutilizables para adjuntar a cualquier agente.
El objeto Skill#
{
"id": "skl_3e8f1a2b4c5d",
"name": "Propuesta comercial",
"description": "Arma propuestas comerciales con el formato de la empresa, con alcance, plazos y precio.",
"instructions": "# Propuesta comercial\n\n1. Empieza por el problema del cliente…",
"scope": "team",
"teamId": "team_9c8b7a6d5e4f",
"ownerId": "usr_1a2b3c4d5e6f",
"canEdit": true,
"usedBy": [{ "id": "agt_8f3a2b1c9d0e", "name": "Analista de CRM" }],
"createdAt": "2026-10-23T09:00:00.000Z",
"updatedAt": "2026-10-26T17:45:00.000Z"
}GET/api/skills#
Lista las skills que puedes ver: { "skills": [Skill, ...] }. Para leer una skill, filtra la lista por id.
curl https://doublex.ai/api/skills -H "Authorization: Bearer $DOUBLEX_API_KEY"POST/api/skills#
| Campo | Tipo | Descripción |
|---|---|---|
name | string, de 2 a 80 | Obligatorio. |
description | string, de 2 a 1024 | Obligatorio. Cuándo debe usar el agente la skill. |
instructions | string, de 2 a 30.000 | Obligatorio. Las instrucciones, en Markdown. |
scope | personal, team, organization | Predeterminado: personal. |
teamId | string | El equipo, cuando scope es team. |
curl -X POST https://doublex.ai/api/skills \
-H "Authorization: Bearer $DOUBLEX_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"name": "Propuesta comercial",
"description": "Arma propuestas comerciales con el formato de la empresa.",
"instructions": "# Propuesta comercial\n\n1. Empieza por el problema del cliente…"
}'Respuesta 201: { "skill": Skill }.
PATCH/api/skills/{id}#
Cambia name, description e instructions (todos opcionales, con los mismos límites). Los agentes que usan la skill pasan a usar la versión nueva en el siguiente mensaje. Requiere permiso de edición; sin él, la respuesta es 404.
Respuesta: { "skill": Skill }.
DELETE/api/skills/{id}#
Borra la skill y la quita de los agentes que la usaban. Respuesta: { "ok": true }.
Paquetes de skills#
Las skills también admiten command (sin /), invocation (auto, manual, both), dependencyIds, files y actions. Las skills relacionadas son procedimientos cargados por el mismo agente; la delegación a subagentes sigue separada. El asistente general descubre las skills visibles y los agentes especializados usan las vinculadas y sus dependencias.
Los archivos nuevos usan { path, mediaType, encoding: "utf8" | "base64", content }. Las actualizaciones pueden conservar archivos propios mediante su metadata (path, mediaType, size, sha256). Límites: 100 archivos, 2 MB por archivo y 10 MB en total. Las referencias se guardan fuera del límite de instrucciones.
GET /api/skills/:id: metadata, instrucciones e índices de archivos y acciones.GET /api/skills/:id/files?path=references/ejemplo.md: descarga autorizada.GET /api/skills/:id/package: exporta.skillconSKILL.md, adjuntos ydoublex.skill.json.
Las acciones tienen id, name, description, enabled y kind. Las de script añaden path y runtime (python, node, shell); las de conexión, connectorId y tool. Las acciones requieren una conexión activa, vinculada y disponible para quien ejecuta, respetando los bloqueos generales y del agente. Importar una skill no concede acceso a cuentas.
Los scripts reciben un objeto JSON por stdin y devuelven texto o JSON por stdout. Los archivos del paquete se montan en /skill, solo para lectura. La ejecución aislada no tiene red ni credenciales del servidor. Límites: entrada de 64 KB, memoria de 128 MB, medio núcleo de CPU, 32 procesos, 35 segundos y dos ejecuciones simultáneas. Python ofrece su biblioteca estándar y Node.js sus módulos nativos; no se instalan bibliotecas adicionales durante la ejecución.
En el chat, /comando pedido invoca la skill para la solicitud actual. Las herramientas listar_skills, usar_skill, ler_arquivo_skill, executar_acao_skill permiten descubrimiento y carga bajo demanda. Cada llamada verifica el acceso, se rechazan dependencias circulares y la conversación registra las skills, archivos y acciones usados. Las skills existentes siguen funcionando.