Primeros pasos
Agentes compatibles
Las skills del paquete siguen el formato del estándar abierto Agent Skills: una
carpeta por skill con un SKILL.md cuyo frontmatter lleva name y
description. Cualquier herramienta que lea ese formato las carga sin cambios.
El paquete las documenta para cinco: Claude Code, Codex, Cursor, OpenCode y Kimi
Code.
Una carpeta, dos rutas de lectura
Sección titulada «Una carpeta, dos rutas de lectura»init instala las skills una sola vez, en .agents/skills/, y crea un enlace
para la herramienta que no lee esa carpeta:
| Agente | Lee las skills desde | Cómo se invoca una skill |
|---|---|---|
| Claude Code | .claude/skills/, que es un enlace simbólico a .agents/skills/ |
Con /nombre |
| Codex | .agents/skills/ |
Con $nombre |
| Cursor | .agents/skills/ |
La carga cuando su descripción coincide con la tarea |
| OpenCode | .agents/skills/ |
La carga cuando su descripción coincide con la tarea |
| Kimi Code | .agents/skills/ |
La carga cuando su descripción coincide con la tarea |
Para Cursor, OpenCode y Kimi Code el paquete no documenta más que eso: que leen
.agents/skills/ de forma nativa y cargan una skill por su descripción. Si tu
herramienta tiene una forma explícita de invocarla, está en su propia
documentación, no en la del paquete.
Cada archivo existe una sola vez: no hay copias que sincronizar. El enlace se versiona en git como enlace, no como copia.
AGENTS.md y CLAUDE.md
Sección titulada «AGENTS.md y CLAUDE.md»AGENTS.md lo leen todas las herramientas; ahí init deja el bloque que dice
qué skill se usa cuándo y dónde escribe cada una. Claude Code lee CLAUDE.md,
que en esta metodología es una sola línea:
@AGENTS.mdinit no escribe CLAUDE.md. El molde está en
templates/CLAUDE_MD_TEMPLATE.md del paquete.
Windows sin enlaces simbólicos
Sección titulada «Windows sin enlaces simbólicos»Si tu equipo trabaja en Windows sin enlaces simbólicos habilitados,
.claude/skills puede ser una copia de .agents/skills/. En ese caso, declara
en AGENTS.md cuál es la fuente y cuál la copia, para que nadie edite la que no
es.
Herramientas sin carga de skills
Sección titulada «Herramientas sin carga de skills»Si tu herramienta no carga skills por su cuenta, guarda los SKILL.md como
documentos en docs/ e indícale desde AGENTS.md cuándo leer cada uno:
## Documentación especializada- Antes de implementar un feature, leer `docs/protocolos/features.md`- Antes de escribir textos visibles, leer `docs/protocolos/ux-writer.md`Menos elegante que la carga automática, mismo resultado.