# Instrucciones para el agente: Agent Skills de Addy Osmani: guía fases del desarrollo de software

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/addyosmani/agent-skills (licencia MIT)
- Guía completa: https://lab.wisd.ai/hub/addyosmani-agent-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 Claude Code abre y reconoce `/plugin`. Ejecuta los dos comandos siguientes dentro de su conversación: primero registran el catálogo y después instalan el plugin.

### Paso 1: instala la integración completa en Claude Code

```text
/plugin marketplace add addyosmani/agent-skills
/plugin install agent-skills@addy-agent-skills
```

### Paso 2: prueba un procedimiento

Pide una especificación o revisión pequeña y verifica qué habilidad activa. Si eliges instalación selectiva por otra vía, comprueba la advertencia del README sobre referencias compartidas.

## Comprobación

La habilidad debe encontrar sus referencias y devolver evidencias concretas del proyecto. Revisa que el comando utilizado pertenece al plugin esperado.

## Si algo falla

Si faltan listas o referencias, revisa si solo instalaste una carpeta. Si hay colisión de nombres, consulta el espacio de nombres del plugin en el README.