# ai-first skill

> Cómo instalar skills sueltas del paquete sin adoptar la metodología, qué escribe, cómo se adaptan y sus opciones.

`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](https://ai-first.falcux.com/docs/referencia/init/).

## Uso

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

Los nombres van separados por comas, sin espacios:

```bash
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](https://ai-first.falcux.com/docs/referencia/skills/).

## Qué escribe

1. **Cada skill**, en `.agents/skills/<nombre>/`. Una que ya existe se salta entera, como en `init`.
2. **Su adaptación**, en la sección «Adaptación a tu proyecto» de su `SKILL.md`, entre `<!-- ai-first:inicio -->` y `<!-- ai-first:fin -->`, si hay con qué adaptarla. Ver [Cómo se adaptan](#c%C3%B3mo-se-adaptan).
3. **`.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:

```text
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`](https://ai-first.falcux.com/docs/referencia/ai-first-md/#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:

```text
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.

Nota

Como las respuestas no se guardan, otra skill que instales después con `skill` vuelve a preguntar. Si eso se repite, quizá te sirve más la metodología: `init` las guarda en `AI-FIRST.md` y las reusa al agregar una skill.

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

```text
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](https://ai-first.falcux.com/docs/referencia/init/#nunca-sobreescribe).

## 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 skills](https://ai-first.falcux.com/docs/referencia/skills/)Qué hace cada skill y cuándo se activa.

[ai-first init](https://ai-first.falcux.com/docs/referencia/init/)La metodología completa, con las respuestas guardadas para la próxima skill.

[Adaptar las skills a tu proyecto](https://ai-first.falcux.com/docs/guias/adaptar-las-skills/)Qué escribe la adaptación dentro de cada skill.
