01 Por qué estas tres y en este orden
Cuando un proyecto con Claude Code se tuerce, casi nunca es porque el modelo no sepa programar. Lo habitual es una de estas tres cosas: Claude ha rellenado con suposiciones lo que no le dijiste, un cambio nuevo ha tocado código que ya funcionaba, o la interfaz final tiene ese aire de plantilla que delata que nadie la ha revisado.
Cada una de estas herramientas ataca uno de esos fallos, y funcionan mejor encadenadas: primero aclarar qué hay que hacer, luego planificar el cambio por escrito y, al final, pulir lo que se ve. Si planificas sin haber aclarado, planificas lo equivocado; si pules antes de tener un plan estable, pules algo que volverá a cambiar.
Grill Me (mattpocock/skills)
Una skill que te entrevista a fondo sobre tu idea, pregunta a pregunta, hasta que no quedan decisiones abiertas. Forma parte de un paquete de skills de ingeniería con licencia MIT.
OpenSpec (Fission-AI)
Un CLI y un conjunto de comandos que guardan cada cambio en su propia carpeta: propuesta, requisitos con escenarios, diseño técnico y lista de tareas. Licencia MIT.
Impeccable (pbakaus)
Una skill de diseño con más de veinte comandos (polish, audit, critique, typeset…) y un detector de patrones visuales típicos de interfaces generadas por IA. Licencia Apache-2.0.
02 Qué necesitas antes de empezar
- ✓Claude Code funcionando en tu ordenador (terminal o app de escritorio).
- ✓Node.js 20.19.0 o superior, que es lo que exige OpenSpec (en macOS también puedes usar Homebrew).
- ✓Un proyecto real con Git inicializado, para poder revisar y deshacer lo que se cambie.
- ✓Un plan de Claude con margen suficiente: las entrevistas y las propuestas consumen bastante contexto.
03 Instalación paso a paso
-
1
Instala las skills de Matt Pocock
En Claude Code se instalan como plugin desde el marketplace oficial con el comando de abajo y se actualizan solas. Si prefieres copias editables en tu proyecto, usa npx skills@latest add mattpocock/skills, pero no instales las dos variantes a la vez o tendrás cada skill duplicada.
-
2
Configúralas una vez por repositorio
Ejecuta /setup-matt-pocock-skills dentro de Claude Code. Te preguntará qué gestor de incidencias usas, qué etiquetas pones al clasificar tareas y dónde guardar la documentación que se genere.
-
3
Instala el CLI de OpenSpec
Es un paquete global de npm (o brew install openspec en macOS y Linux). Después, dentro de la carpeta del proyecto, ejecuta openspec init y elige Claude Code entre las herramientas: creará la carpeta openspec/ y los comandos /opsx.
-
4
Instala Impeccable
Desde la raíz del proyecto ejecuta npx impeccable install. Detecta las herramientas que tienes, te deja elegir proyecto o global e instala la skill. Reinicia Claude Code al terminar.
-
5
Arranca Impeccable con init
En una sesión de Claude Code escribe /impeccable init. Revisa el proyecto, te pregunta lo que falte sobre público, propósito y tono, y lo guarda en PRODUCT.md para que el resto de comandos lo tengan en cuenta.
# 1. Skills de Matt Pocock (plugin de Claude Code)
claude plugin install mattpocock-skills@claude-plugins-official
# 2. OpenSpec
npm install -g @fission-ai/openspec@latest
cd tu-proyecto
openspec init
# 3. Impeccable (desde la raíz del proyecto)
npx impeccable install04 Paso 1: aclarar el encargo con Grill Me
/grill-me invierte la conversación: en lugar de que tú expliques y Claude ejecute, Claude pregunta y tú decides. Recorre cada rama de la idea (quién lo usa, qué pasa con los datos vacíos, qué queda fuera) hasta que no hay huecos. Si trabajas en código y quieres además un glosario del dominio y registros de decisiones, el mismo paquete trae /grill-with-docs.
/grill-me Quiero añadir [describe la función en una o dos frases] a este proyecto. Antes de escribir código, entrevístame: una pregunta cada vez, empezando por las que más condicionan el diseño. Incluye qué queda explícitamente fuera del alcance. Cuando no queden dudas, resúmelo en una lista de requisitos y espera mi visto bueno.05 Paso 2: planificar con OpenSpec
Con el alcance claro, OpenSpec lo convierte en archivos. /opsx:propose nombre-del-cambio crea openspec/changes/nombre-del-cambio/ con proposal.md, una carpeta specs/ con requisitos y escenarios, design.md y tasks.md. Lo revisas, corriges lo que haga falta y solo entonces ejecutas /opsx:apply. Al terminar, /opsx:archive mueve el cambio al archivo y actualiza las specs del proyecto.
Si todavía dudas entre enfoques, /opsx:explore lee tu código y te ayuda a decidir sin comprometer nada.
Con los requisitos que acabamos de cerrar, ejecuta /opsx:propose [nombre-corto-del-cambio]. En design.md indica qué archivos existentes vas a tocar y por qué, y en tasks.md deja tareas pequeñas que se puedan comprobar una a una. No implementes nada: quiero revisar la propuesta primero.06 Paso 3: pulir la interfaz con Impeccable
Cuando la función ya funciona, toca el aspecto. Impeccable agrupa todo bajo /impeccable: critique revisa jerarquía y claridad, audit comprueba accesibilidad, rendimiento y adaptación a móvil, y polish hace la pasada final. Detecta vicios habituales como la tipografía Inter en todo, los degradados de morado a azul, tarjetas dentro de tarjetas o texto gris sobre fondos de color.
/impeccable critique [pantalla o componente]. Después aplica /impeccable polish sobre lo mismo respetando PRODUCT.md. Al terminar, dame una lista de los cambios visuales que has hecho y cuáles de los problemas detectados has dejado sin tocar y por qué.07 Cuándo no usar el trío completo
| Situación | Qué hacer |
|---|---|
| Cambio de cinco minutos (un texto, un color) | Pídeselo directamente a Claude; la entrevista y la propuesta son más trabajo que el cambio. |
| Proyecto sin interfaz (API, scripts, automatizaciones) | Usa Grill Me y OpenSpec; Impeccable no aporta nada. |
| Primeros días con Claude Code | Aprende primero cómo trabaja sin añadidos y suma las skills cuando tengas un proyecto real. |
| Equipo con un proceso propio que ya funciona | Prueba una sola herramienta en el siguiente proyecto antes de cambiar todo el flujo. |
Preguntas frecuentes
No. Las tres son compatibles con otros agentes de programación como Codex, Cursor o Gemini CLI, aunque el comando de instalación cambia en cada caso. Esta guía usa los de Claude Code.
Las dos te entrevistan igual. La segunda además va construyendo un glosario del proyecto y registra decisiones de arquitectura, por lo que tiene más sentido en repositorios de código con vida larga.
Son alternativas para el mismo paso. OpenSpec es más ligero y permite editar cualquier artefacto en cualquier momento; Spec Kit, de GitHub, tiene fases más rígidas. Elige uno, no los dos.
Recoge estadísticas anónimas de uso (nombre del comando y versión, sin contenido ni rutas). Puedes desactivarlas con openspec config set telemetry.enabled false o con la variable OPENSPEC_TELEMETRY=0.
No. La skill funciona con el modelo que ya usas en Claude Code y su detector de patrones se ejecuta en local sin modelo ni clave.
Sobre el autor
Equipo editorial de appyweb
Marketing, SEO y desarrollo con IA
Especialistas de appyweb en SEO, publicidad, desarrollo web y automatización con IA.