# Agentes compatibles

> Cómo leen las skills y el AGENTS.md Claude Code, Codex, Cursor, OpenCode y Kimi Code, y qué hacer con una herramienta que no carga skills.

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

`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

`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:

```md
@AGENTS.md
```

`init` no escribe `CLAUDE.md`. El molde está en `templates/CLAUDE_MD_TEMPLATE.md` del paquete.

## 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

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:

```md
## 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.

Nota

El paquete no instala hooks del agente, como `PostToolUse` o `Stop`: cada herramienta los configura en su propio formato y quedaron fuera del estándar *Agent Skills*. El hook que deja `init` es de git, `.githooks/pre-push`, y funciona igual con cualquier agente.

## Próximos pasos

[Qué deja init en tu repo](https://ai-first.falcux.com/docs/empezar/que-instala/)Las skills, el enlace y el bloque de AGENTS.md, pieza por pieza.

[Las 11 skills](https://ai-first.falcux.com/docs/referencia/skills/)Qué hace cada una y cuándo se activa.

[Adaptar las skills](https://ai-first.falcux.com/docs/guias/adaptar-las-skills/)Que cada skill conozca tus comandos y tu orden de implementación.