Comandos

ai-first skill

skill instala skills del paquete sin la metodología. Escribe sólo .agents/skills/<nombre> y el enlace .claude/skills: ni AI-FIRST.md, ni docs/, ni AGENTS.md, ni el hook de git, ni el flujo de integración continua. Tampoco necesita git. Existe desde la 0.7.0.

Es para quien quiere una skill concreta —test-fix, ux-writer— en un proyecto que no va a adoptar el resto. Para la metodología completa, ai-first init.

Uso

ai-first skill <nombres> [--raiz <dir>] [--enlazar]
                         [--entrevista | --sin-entrevista]

Los nombres van separados por comas, sin espacios:

npx @falcux/ai-first@latest skill test-fix,version-bump

Un nombre que el paquete no trae detiene el comando antes de instalar nada, con la lista de las disponibles. El catálogo está en Las 12 skills.

Qué escribe

Cada skill, en .agents/skills/<nombre>/. Una que ya existe se salta entera, como en init.
Su adaptación, en la sección «Adaptación a tu proyecto» de su SKILL.md, entre  y , si hay con qué adaptarla. Ver Cómo se adaptan.
.claude/skills, el enlace simbólico relativo a .agents/skills/ para que Claude Code las lea, si ahí no hay nada todavía.

No corre git init ni toca la configuración de git. El reporte cierra recordándolo:

Sólo skills: ni AI-FIRST.md, ni docs/, ni AGENTS.md, ni punto de control. Para la metodología, `ai-first init`.

Cómo se adaptan

Depende de dónde salen las respuestas:

Situación	Qué pasa
Hay un `AI-FIRST.md` con `perfil`	Adapta con lo que guarda: el perfil, la verificación y el mapa `adaptacion`. No pregunta nada
No lo hay, y hay terminal interactiva	Pregunta sólo lo que leen las skills que nombraste, y nada más. Las respuestas van a cada skill y no se guardan en ningún otro sitio
No lo hay, y no hay terminal, o con `--sin-entrevista`	No pregunta. Cada skill que se adapta queda `sugerido`, con la razón y que su «Adaptación a tu proyecto» se completa a mano

Una skill que no lee ninguna respuesta, como i18n, se instala sin bloque.

Antes de preguntar, dice cuántas preguntas son y dónde va lo respondido:

5 preguntas, todas con un valor por defecto entre corchetes: Enter lo acepta.
Se escriben sólo en la sección «Adaptación a tu proyecto» de cada skill.

Si cancelas a mitad, con Ctrl+C o Ctrl+D, no se escribe nada.

Opciones

Opción	Qué hace	Por defecto
`--raiz <dir>`	Carpeta del proyecto.	El directorio actual
`--enlazar`	Instala las skills como enlaces simbólicos a la carpeta `skills/` del paquete, en vez de copiarlas. Una skill enlazada nunca se adapta.	Copia
`--entrevista`	Pregunta aunque `AI-FIRST.md` tenga respuestas guardadas. Necesita una terminal interactiva.	Pregunta sólo si no hay respuestas guardadas
`--sin-entrevista`	No pregunta nunca. Sin respuestas guardadas, las skills quedan sin adaptar y el reporte lo dice.	—

--entrevista y --sin-entrevista se contradicen: pasar las dos sale con 2.

Salida

skill i18n,test-fix en una carpeta vacía, sin terminal interactiva:

ai-first skill — suelta

  escrito  .agents/skills/i18n
  escrito  .agents/skills/test-fix
  sugerido .agents/skills/test-fix/SKILL.md — sin respuestas con qué adaptarla: no hay AI-FIRST.md con perfil ni terminal para entrevistar. Completa a mano su «Adaptación a tu proyecto»
  escrito  .claude/skills

  Sólo skills: ni AI-FIRST.md, ni docs/, ni AGENTS.md, ni punto de control. Para la metodología, `ai-first init`.

i18n no aparece como sugerida porque no tiene nada que adaptar. Las líneas escrito, saltado y sugerido significan lo mismo que en init.

Códigos de salida

Código	Cuándo
`0`	Terminó, aunque haya saltado o sugerido cosas.
`2`	Error de uso: sin nombres, una skill que el paquete no trae, dos opciones que se contradicen, `--entrevista` sin terminal interactiva o una entrevista cancelada.

Relacionado

Las 12 skillsQué hace cada skill y cuándo se activa.

ai-first initLa metodología completa, con las respuestas guardadas para la próxima skill.

Adaptar las skills a tu proyectoQué escribe la adaptación dentro de cada skill.