AI Skill · SKILL.md
Enseña a tu agente de IA a integrar Shalom.
Publicamos una skill en formato SKILL.md (el estándar de Agent Skills) con todo lo que una IA necesita para integrar Shalom API: autenticación, endpoints esenciales, 5 recetas paso a paso (rastrear, agencia más cercana, cotizar, crear guías en Shalom Pro y verificar webhooks) y reglas de operación. Es compatible con Claude Code, Cursor, Codex, OpenCode, VS Code y otros agentes que soporten el formato.
Qué aprende el agente
Autenticación con x-api-key, los 20+ endpoints con request/response reales, errores y límites.
Qué puede hacer después
Rastrear guías, encontrar la agencia más cercana, cotizar y crear envíos reales en Shalom Pro desde una conversación o flujo.
Reglas anti-alucinación
El skill prohíbe inventar endpoints, marca las operaciones Pro y define reintentos ante 429 con backoff.
Instalación
Método A — Descarga directa (recomendado)
Descarga el skill dentro de la carpeta de skills de tu proyecto (.agents/skills/). El agente lo detecta 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.mdEl archivo se sirve en https://shalom-api.lat/skill/SKILL.md y se actualiza junto con la documentación.
Método B — Desde el repositorio de GitHub
Instala la skill desde el repositorio público con el gestor de skills de tu agente:
npx skills add ronnaldrangel/shalom-api-skillRepo: github.com/ronnaldrangel/shalom-api-skill · Listado: skills.sh/ronnaldrangel/shalom-api-skill
Prueba que la IA quedó lista
Con la skill instalada, pídele a tu agente algo concreto:
Usa la skill shalom-api: rastrea la guía 66479331 con código 3KTH y dime en qué estado está.Necesitará tu API key: configúrala como variable de entorno (por ejemplo SHALOM_API_KEY) o pídesela al agente.