Ir al contenido
SShalom API

Instalar la skill de IA

Instala la skill shalom-api en tu agente de IA (Claude Code, Cursor, Codex, OpenCode, VS Code) y enseña a la IA a rastrear envíos, buscar agencias, cotizar y crear guías de Shalom por API.

La skill de IA es un archivo SKILL.md (estándar de Agent Skills) que se publica en https://shalom-api.lat/skill/SKILL.md. Es corta a propósito: trae la autenticación, los límites y las reglas que rompen integraciones (instancias de Shalom Pro, códigos del catálogo, clave de recojo, formato de los pendientes, webhooks), y para el detalle de cada endpoint remite a esta documentación y a su llms.txt. Así no se desactualiza: los endpoints viven en un solo lugar. Compatible con Claude Code, Cursor, Codex, OpenCode, VS Code y cualquier agente que soporte el formato.

Qué es una skill de IA

Es un archivo de instrucciones que tu agente carga para saber cómo usar un servicio: qué endpoints existen, cómo autenticarse y qué formato tienen las respuestas. Sin ella, el agente improvisa y suele inventar parámetros.

La de Shalom API enseña al agente a rastrear envíos, buscar agencias, cotizar y crear guías en Shalom Pro.

Dónde se instala

Cada agente tiene su carpeta de skills. La guía cubre Claude Code, Cursor, Codex, OpenCode y VS Code. Si usas otro, el archivo SKILL.md sirve igual: es texto plano.

La API key va en el entorno

No escribas la key dentro de la skill. El agente la lee de una variable de entorno, igual que haría tu código. Así puedes compartir la skill con tu equipo sin repartir credenciales.

Comprobar que quedó lista

Pídele al agente que consulte las agencias de Cusco por API. Si responde con datos reales y no con un ejemplo inventado, la skill está activa y con la key bien configurada.

Descarga la skill desde shalom-api.lat

Crea la carpeta de skills de tu proyecto y descarga el SKILL.md servido en producción (se actualiza junto con la documentación). Codex y Antigravity leen .agents/skills/; en Claude Code usa .claude/skills/ en su lugar. Hay una guía por agente en shalom-api.lat/claude, /codex, /grokbot, /antigravity y /hermes. El agente detecta la skill al iniciar la siguiente sesión.

mkdir -p .agents/skills/shalom-api
curl -o .agents/skills/shalom-api/SKILL.md https://shalom-api.lat/skill/SKILL.md

Configura tu API key

El agente necesita una API key para operar. Expórtala como variable de entorno en tu proyecto o pídesela al agente cuando la pida.

# .env de tu proyecto
SHALOM_API_KEY=sk_tu_api_key

Prueba que la IA quedó lista

Con la skill instalada, pídele a tu agente algo concreto. Debería usar POST /track con tu API key y devolverte el estado de la guía.

prompt
Usa la skill shalom-api: rastrea la guía 66479331 con código 3KTH y dime en qué estado está.

Preguntas frecuentes

Relacionado