SKILLS

Enséñale Bentho a tu agente

Si un agente escribe tu integración o llama a la API por ti, dale el contexto correcto en vez de dejar que lo adivine. Aquí tienes dos formas: una skill lista para instalar y el texto de toda la documentación en formato para modelos.

Skill bentho-api

Un SKILL.md con lo que un agente necesita para usar la API sin inventar nada: cómo autenticarse, qué ruta usar para cada tarea, qué significan status_code, confidence y warning, y cómo reaccionar a cada error (cuándo reintentar y cuándo parar).

Ver o descargar SKILL.md

llms.txt

Para agentes que leen documentación por su cuenta:

/llms.txt: el índice de páginas, con una línea por página.
/llms-full.txt: todo el contenido en texto plano, en un solo archivo.

Instálala en tu agente

Claude Code

Las skills de un proyecto viven en .claude/skills/. Desde la raíz de tu repositorio:

BASH

mkdir -p .claude/skills/bentho-api
curl -fsSL https://dev.bentho.org/skills/bentho-api/SKILL.md \
  -o .claude/skills/bentho-api/SKILL.md

El agente la usa cuando la tarea tiene que ver con Bentho. Necesita la clave en una variable de entorno (BENTHO_KEY), nunca pegada en el código.

Otros agentes

Pásale la URL de /llms.txt o el contenido de SKILL.md como instrucciones del sistema.

Dale la clave con el menor permiso que sirva. Si el agente solo pregunta y lee, usa una clave lee: no podrá subir ni borrar documentos ni cambiar la configuración.