Skills para agentes
Cómo usar pos-sdk-skill y cuándo usar pos-skills.
Cartamatic separa skills de consumo y skills de implementación.
Separación de responsabilidades
pos-sdk-skill es para apps consumidoras; pos-skills es para agentes que mantienen adapters y contexto provider-specific.
Repos
Cartamatic/pos-sdk-skill
Agentes que trabajan en apps consumidoras del SDK.
Cartamatic/pos-skills
Agentes que implementan o mantienen adapters de providers.
Cartamatic/pos-sdk
Fuente de verdad del SDK y generador de skill.
Instalar skill en app consumidora
git clone git@github.com:Cartamatic/pos-sdk-skill.git .agents/pos-sdk-skillIgnorar el clone local:
.agents/pos-sdk-skill/Configurar la herramienta de agentes para cargar:
.agents/pos-sdk-skill/skillsEjemplos por agente
OpenCode
Carga el skill desde la configuración del workspace o ruta local de skills.
.agents/pos-sdk-skill/skillsCursor
Incluye la guía del skill como contexto del repo o referencia persistente del proyecto.
@cartamatic-pos-sdkClaude Code
Apunta el contexto del agente a la skill consumidora, no al repo provider-specific.
cartamatic-pos-sdkGitHub Copilot
Usa instrucciones del repo y enlaza la referencia del SDK para tareas de consumo.
AGENTS.md + pos-sdk-skillChatGPT / Codex
Entrega la skill o esta documentación como contexto antes de pedir cambios de integración.
server-side onlyRegla de contexto
Carga pos-sdk-skill en apps consumidoras. No cargues Cartamatic/pos-skills salvo que el agente esté implementando o manteniendo adapters dentro del SDK.
Skill disponible
| Skill | Propósito |
|---|---|
cartamatic-pos-sdk | Consumir @cartamatic/pos-sdk desde apps Cartamatic server-side. |
Flujo de generación
La fuente de verdad está en Cartamatic/pos-sdk.
Actualizar fuente en pos-sdk
La fuente de verdad está en Cartamatic/pos-sdk.
Ejecutar generación
Corre pnpm generate:sdk-skill desde el SDK.
Abrir PR en pos-sdk-skill
Copia la skill generada, abre o actualiza PR y espera review humano.
La PR automática la abre el workflow Publish Package del SDK cuando se publica un GitHub Release o se ejecuta manualmente.
Changelog del SDK
Cuando exista changelog versionado en Cartamatic/pos-sdk, úsalo como checklist inicial para actualizar esta documentación y la skill generada. Luego confirma cada punto contra el código real antes de documentarlo.
Qué no hacer
Pendiente
Después de completar esta documentación, hay que auditar Cartamatic/pos-sdk-skill contra el SDK real y estas páginas para confirmar que la skill esté completa.