# Instrucciones para el agente: Agentic Awesome Skills: busca y revisa skills para tu proyecto

Pega este texto a tu agente (Claude Code, Codex, OpenCode, Hermes o el que uses) y dile «ayúdame a montarlo». Son los pasos para ponerlo en marcha; el porqué de cada pieza está en la guía completa.

- Dificultad: intermedio
- Proyecto: https://github.com/sickn33/agentic-awesome-skills (licencia MIT)
- Guía completa: https://lab.wisd.ai/hub/agentic-awesome-skills

---

## Para el agente: cómo acompañar al usuario

1. Pregunta primero para qué lo quiere. Si su objetivo no necesita algún paso, sáltalo.
2. Antes de instalar, comprueba lo que ya tiene (versiones, claves, sistema operativo).
3. Avanza un paso cada vez: explica en una frase qué vas a hacer y deja que el usuario lo ejecute o lo apruebe.
4. Tras cada paso, comprueba que funcionó antes de seguir. Si falla, para y explica el error.
5. No inventes comandos ni opciones: si la documentación del proyecto contradice estos pasos, manda la documentación.
6. Al terminar, haz una prueba real con el objetivo del usuario y dile dónde profundizar.

---

## Pasos de configuración

Comprueba que Node.js ≥22 y npm están disponibles; el mínimo consta en [package.json](https://github.com/sickn33/agentic-awesome-skills/blob/v20.0.0/package.json). `--dry-run` previsualiza la instalación sin aplicarla.

### Paso 1: define una selección pequeña

Elige una tarea repetida y lee las skills candidatas en el repositorio. El ejemplo del [README](https://github.com/sickn33/agentic-awesome-skills/blob/e8d346bcb691225fb6ae51a49c353bcedb2ef61d/README.md#install-selected-skills-directly) usa brainstorming y systematic-debugging. Ambas imponen un método de trabajo; inspecciona su contenido antes de incorporarlas.

### Paso 2: previsualiza una instalación directa

Desde el proyecto de destino, usa el comando oficial:

```bash
npm exec --yes --ignore-scripts --package=agentic-awesome-skills@20.0.0 --   agentic-awesome-skills --release 20.0.0 --path .agents/skills   --skills brainstorming,systematic-debugging --dry-run
```

Revisa los IDs, el destino y las modificaciones. Confirma que tu arnés descubre .agents/skills. El ejemplo está fijado a una versión para que la revisión corresponda a la instalación.

### Paso 3: instala la selección revisada

El README indica repetir sin --dry-run cuando estés listo. Para la selección anterior:

```bash
npm exec --yes --ignore-scripts --package=agentic-awesome-skills@20.0.0 --   agentic-awesome-skills --release 20.0.0 --path .agents/skills   --skills brainstorming,systematic-debugging
```

Si quieres que el agente explore el catálogo antes de escoger IDs, sigue la [guía Core v20.0.0](https://github.com/sickn33/agentic-awesome-skills/blob/v20.0.0/docs/users/aas-core.md). Ese recorrido requiere configurar su MCP local y revisar un plan; no lo confundas con el instalador directo de este ejemplo.

## Comprobación

Confirma que solo se incorporaron los IDs revisados y que el arnés reconoce sus SKILL.md. En una tarea pequeña, pide usar brainstorming para preparar un diseño o systematic-debugging para investigar un fallo. Comprueba que el comportamiento coincide con las instrucciones leídas.

## Si algo falla

Revisa la ruta de skills de tu arnés y la versión usada. Si demasiadas skills interfieren en la tarea, reduce la selección. Un plan de Core válido comprueba estructura e identidad, pero no compatibilidad ni adecuación; vuelve a leer los archivos implicados antes de aplicar cambios experimentales.