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).

Trae además una referencia por parte de la API (references/nucleo.md, references/agente.md, references/productos.md…) con cada ruta entera: cuerpo, respuesta, errores literales y notas. Salen de estas mismas páginas, así que dicen lo mismo que la documentación. El agente lee solo la del módulo que va a usar.

Ver SKILL.md · índice de la skill

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

Con el gestor de skills

Desde la raíz de tu repositorio (necesitas Node). Instala la skill con sus referencias en los agentes que tengas (Claude Code, Cursor y otros):

BASH

npx skills add https://dev.bentho.ai

También está en GitHub, en BenthoRAG/skills, un espejo de esta página que se pone al día cada día: npx skills add BenthoRAG/skills.

Con -g queda para todos tus proyectos. Para ponerla al día cuando cambie la API: npx skills update.

A mano

Copia la carpeta /skills/bentho-api/ en la de skills de tu agente (en Claude Code, .claude/skills/bentho-api/). Los archivos son los que lista el índice; como mínimo, SKILL.md:

BASH

mkdir -p .claude/skills/bentho-api
curl -fsSL https://dev.bentho.ai/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.