Guía de mattpocock/skills: 27 skills para vibe coding fiable
Domina los 27 skills de IA de Matt Pocock para Claude Code, Codex y Cursor: instalación en 30s, flujo /grill-with-docs, TDD y combinación con Caveman.
Índice
- 1. Autor y filosofía
- 2. ¿Por qué usarlo? 4 modos de fallo
- 3. Instalación en 30 segundos
- 4. Dos conceptos clave
- 5. La receta práctica de 7 pasos
- 6. Tres flujos de trabajo habituales
- 7. Explorador de los 27 skills
- 8. Ocho consejos prácticos
- 9. Combinarlo con Caveman y Ponytail
- 10. Preguntas frecuentes (FAQ)
1. Autor y filosofía
Matt Pocock, referente del ecosistema TypeScript y creador de Total TypeScript, define mattpocock/skills como "los skills que uso a diario para hacer ingeniería real con agentes de IA".
Frente a metodologías pesadas como GSD, BMAD o Spec-Kit—que controlan todo el flujo de arriba abajo y vuelven muy difícil depurar cuando una pieza falla—, estos skills siguen cuatro principios claros:
- Pequeños — cada archivo es un bloque compacto de reglas.
- Componibles — eliges solo lo que necesita tu tarea actual.
- Fáciles de editar — puro texto Markdown que puedes adaptar a tu gusto.
- Independientes del modelo — funcionan igual en Claude Code, Codex, Gemini o cualquier agente moderno.
2. ¿Por qué usarlo? 4 modos de fallo
El repositorio está pensado para corregir uno a uno los cuatro fallos típicos de los agentes de programación:
| Fallo | Síntoma habitual | Skill que lo resuelve |
|---|---|---|
| 1. No construye lo que querías | Creías haberlo explicado todo, pero el resultado hace otra cosa por suposiciones ocultas. | /grill-me · /grill-with-docs — Sesión de interrogatorio: el agente te hace preguntas concretas antes de programar. |
| 2. Demasiado verboso | Usa 20 frases para explicar algo simple y reinventa los términos del proyecto en cada chat. | Lenguaje ubicuo — /grill-with-docs genera un glosario (GLOSSARY.md) y registros ADR que acortan futuros chats y ahorran tokens. |
| 3. El código no funciona | La dirección es buena, pero el código sale roto porque el agente vuela a ciegas. | Bucles de feedback — tdd (test fallido → pasar → limpiar) y diagnosing-bugs (depuración disciplinada). |
| 4. Bola de lodo (Ball of mud) | Cuanto más rápido genera código la IA, más rápido crece la deuda técnica y la complejidad. | Inversión diaria en diseño — /to-spec (revisión modular previa) y /improve-codebase-architecture (auditoría periódica). |
3. Instalación en 30 segundos
3.1 Instalar los skills según tu agente
claude plugin install mattpocock-skills@claude-plugins-official3.2 Una sola vez por repositorio: /setup-matt-pocock-skills
Ejecuta /setup-matt-pocock-skills dentro del chat del agente y responde tres preguntas:
- Qué gestor de incidencias usas (GitHub, GitLab, archivos locales o tu flujo propio)
- Etiquetas de clasificación (usadas por
/triage) - Dónde guardar la documentación (especificaciones,
GLOSSARY.mdy ADRs)
Con esa configuración única por proyecto, todos los skills de ingeniería quedan listos.
4. Dos conceptos clave
4.1 ¿Quién invoca cada skill? (Director vs. Disciplina)
- Invocados por ti (
user-invoked, 16): Directores de orquesta que solo arrancan cuando escribes/comando(ej./grill-with-docs,/implement,/retro). - Invocados por el modelo (
model-invoked, 11): Disciplinas reutilizables que el agente activa por su cuenta o desde un director (ej.tdd,code-review,grilling). - Regla de oro: un skill manual puede llamar a skills automáticos, pero nunca encadena otro skill manual.
4.2 Lenguaje ubicuo (GLOSSARY.md)
Centralizar el vocabulario del dominio unifica nombres de variables, funciones y archivos, reduciendo búsquedas y tokens de razonamiento.
Ejemplo real: en vez de repetir "hay un problema cuando una lección dentro de una sección dentro de un curso se materializa en el sistema de archivos", bautizarlo "materialization cascade" convierte toda una frase en un solo término preciso.
5. La receta práctica de 7 pasos
Cada vez que quieras construir una funcionalidad nueva, sigue este orden exacto:
- 1Alinear el rumbo — Interrogatorio de diseño
/grill-with-docsEl agente te pregunta cada bifurcación del diseño mientras construye automáticamente GLOSSARY.md y los registros ADR.
- 2Consolidar la especificación — Sin preguntas redundantes
/to-specResume toda la conversación en una especificación limpia y la publica en el gestor elegido durante el setup.
- 3Dividir en tickets — Trazas verticales con dependencias
/to-ticketsParte la especificación en tickets tracer-bullet (modelo → vista de hoy → completar/posponer) marcando qué ticket bloquea a cuál.
- 4Implementar — Tests primero y revisión automática
/implementPrograma ticket por ticket ejecutando ciclos tdd (rojo → verde → refactor) y lanza code-review antes de cada commit.
- 5Revisión paralela en dos ejes — Estándares + Especificación
/code-reviewDos subagentes independientes revisan en paralelo reglas de código/olores de Fowler y cumplimiento estricto de la especificación.
- 6Redactar PR — Resumen visual, pruebas y riesgo de fusión
/prGenera el cuerpo del Pull Request con evidencia antes/después, resumen visual mínimo y análisis de reversibilidad.
- 7Retrospectiva — Mejora continua del entorno del agente
/retroAl cerrar la sesión, propone mejoras priorizadas por severidad en tus checks automáticos, reglas y herramientas.
Ejemplo real del paso 1
/grill-with-docs Quiero crear una app de tareas diarias recurrentes donde por la mañana solo aparezcan las tareas de hoy.- Pregunta del agente: "¿'Completado' solo marca el check? ¿Qué pasa al día siguiente si una tarea vence? ¿Las tareas recurrentes saltan los festivos?"
- Tu respuesta: "Completado solo marca el check. Si vence, aparece un botón 'pasar a mañana'. En festivos la tarea recurrente se omite."
Si solo recuerdas una regla: empieza siempre por /grill-with-docs, y usa /ask-matt siempre que dudes qué comando toca después.
6. Tres flujos de trabajo habituales
Escenario A: Nueva funcionalidad"Crea una app de tareas diaria"
“/setup-matt-pocock-skills → /grill-with-docs”
- 1. Preparación
- /setup-matt-pocock-skills (admite archivos locales)
- 2. Diseño
- /grill-with-docs aclara bordes y construye GLOSSARY.md
- 3. Desarrollo
- /to-spec → /to-tickets → /implement (con TDD por ticket)
- 4. Cierre
- /code-review + /pr para validar y abrir Pull Request
Escenario B: Bug rebelde"Lo arreglé dos veces y sigue fallando"
“diagnosing-bugs → tdd”
- Activación
- El agente invoca diagnosing-bugs automáticamente al investigar fallos
- Bucle
- Reproducir (rojo) → minimizar → hipótesis → medir → corregir → test de regresión
- Ventaja
- Evita cambios a ciegas tipo 'a ver si esto lo arregla'
- Blindaje
- Con la causa raíz clara, tdd fija primero un test que falle
Escenario C: Iniciativa grande"Demasiado grande para un solo chat"
“/wayfinder · /implement-spec · /improve-codebase-architecture”
- Mapa de ruta
- /wayfinder divide trabajos grandes en un mapa de tickets de decisión
- Ejecución paralela
- /implement-spec orquesta subagentes en paralelo sobre una rama común
- Salud estructural
- /improve-codebase-architecture genera informes HTML cada pocos días
- Nota
- El informe detecta deuda; elige un punto y entra en interrogatorio para resolverlo
7. Explorador de los 27 skills
En total hay 16 skills manuales (11 de ingeniería + 5 de productividad) y 11 skills automáticos (9 de ingeniería + 2 de productividad). Filtra por grupo o busca por palabra clave:
- Punto de partida: entrevista de diseño + GLOSSARY y ADRManual· Manual · Ingeniería
Recorre cada decisión de arquitectura mediante preguntas y genera GLOSSARY.md y ADRs.
Skill:/grill-with-docsÁrea:Ingeniería - Convertir la entrevista en especificación formalManual· Manual · Ingeniería
Sintetiza lo acordado sin repreguntar y sube el documento al gestor configurado.
Skill:/to-specÁrea:Ingeniería - Trocear la especificación en tickets con dependenciasManual· Manual · Ingeniería
Crea tickets verticales tracer-bullet señalando qué tarea bloquea a cuál.
Skill:/to-ticketsÁrea:Ingeniería - Implementar tickets con TDD y revisión previa al commitManual· Manual · Ingeniería
Aplica ciclos tdd en hitos definidos y llama a code-review automáticamente antes de commitear.
Skill:/implementÁrea:Ingeniería - Implementar toda una spec en paralelo sobre rama integradaManual· Manual · Ingeniería
Analiza el grafo de tickets y lanza subagentes de implementación en paralelo.
Skill:/implement-specÁrea:Ingeniería - Guiar proyectos grandes que superan una sesiónManual· Manual · Ingeniería
Construye un mapa de tickets de decisión para avanzar paso a paso sin perder contexto.
Skill:/wayfinderÁrea:Ingeniería - Detectar oportunidades de módulos profundos (informe HTML)Manual· Manual · Ingeniería
Escanea el repositorio cada pocos días buscando interfaces pequeñas con lógica sólida.
Skill:/improve-codebase-architectureÁrea:Ingeniería - Clasificar incidencias mediante máquina de estadosManual· Manual · Ingeniería
Aplica las etiquetas definidas en el setup inicial para ordenar issues.
Skill:/triageÁrea:Ingeniería - No saber qué skill conviene usar ahoraManual· Manual · Ingeniería
Evalúa tu tarea actual y recomienda el skill o flujo exacto a seguir.
Skill:/ask-mattÁrea:Ingeniería - Configuración única por repo (tracker, etiquetas, ruta de docs)Manual· Manual · Ingeniería
Define las rutas base que necesitan los demás skills. Obligatorio en instalación manual.
Skill:/setup-matt-pocock-skillsÁrea:Ingeniería - Retrospectiva final para mejorar el entorno del agenteManual· Manual · Ingeniería
Propone mejoras en tests automáticos, reglas y herramientas ordenadas por impacto.
Skill:/retroÁrea:Ingeniería - Entrevista implacable para planes o diseños sin códigoManual· Manual · Productividad
Pone a prueba ideas de producto o arquitectura mediante preguntas directas.
Skill:/grill-meÁrea:Productividad - Comprimir una conversación larga para continuar en otra sesiónManual· Manual · Productividad
Genera un documento de traspaso compacto para que otro agente retome el trabajo.
Skill:/handoffÁrea:Productividad - Aprender un tema complejo a lo largo de varias sesionesManual· Manual · Productividad
Convierte una carpeta en un espacio de aprendizaje guiado paso a paso.
Skill:/teachÁrea:Productividad - Transformar decisiones pendientes en cuestionario humanoManual· Manual · Productividad
Estructura dudas abiertas para que otras personas puedan responder rápido.
Skill:/to-questionnaireÁrea:Productividad - Pedir reexplicación inmediata cuando algo no encajaManual· Manual · Productividad
Completa el contexto faltante y vuelve a explicarlo usando el vocabulario del glosario.
Skill:/wait-whatÁrea:Productividad - Ciclo Rojo → Verde → Refactor por cada corte verticalAuto· Auto · Ingeniería
Exige escribir primero un test que falle, hacerlo pasar con lo mínimo y refactorizar.
Skill:tddÁrea:Ingeniería - Revisión paralela en dos ejes (estándares + spec)Auto· Auto · Ingeniería
Usa dos subagentes aislados para detectar olores de código y requisitos olvidados.
Skill:code-reviewÁrea:Ingeniería - Cuerpo de PR con resumen visual, pruebas y riesgo de fusiónAuto· Auto · Ingeniería
Redacta Pull Requests claros con evidencia de funcionamiento y reversibilidad.
Skill:prÁrea:Ingeniería - Bucle metódico para bugs difíciles y regresionesAuto· Auto · Ingeniería
Ordena reproducción, aislamiento, hipótesis, medición, arreglo y test de regresión.
Skill:diagnosing-bugsÁrea:Ingeniería - Pulir el modelo de dominio frente al glosario y casos límiteAuto· Auto · Ingeniería
Valida tipos y fronteras del negocio contra GLOSSARY.md.
Skill:domain-modelingÁrea:Ingeniería - Vocabulario común para diseñar módulos profundosAuto· Auto · Ingeniería
Guía la creación de interfaces simples y módulos fáciles de probar por humanos e IA.
Skill:codebase-designÁrea:Ingeniería - Prototipo desechable (HTML/UI) para resolver dudas de diseñoAuto· Auto · Ingeniería
Permite validar estados o diseños rápidamente antes de escribir código definitivo.
Skill:prototypeÁrea:Ingeniería - Investigación de fuentes primarias guardada en MarkdownAuto· Auto · Ingeniería
Recopila hechos verificados de documentación oficial en segundo plano con citas.
Skill:researchÁrea:Ingeniería - Asistente bash interactivo para pasos solo humanosAuto· Auto · Ingeniería
Guía al usuario en tareas de credenciales, infraestructura o migraciones manuales.
Skill:wizardÁrea:Ingeniería - Motor de entrevistas compartido por 5 skills de diseño/triajeAuto· Auto · Productividad
Núcleo reutilizable detrás de grill-me, grill-with-docs, triage y wayfinder.
Skill:grillingÁrea:Productividad - Cómo redactar archivos CLAUDE.md, AGENTS.md y SKILL.mdAuto· Auto · Productividad
Sustituye prosa larga por instrucciones directas, breves y económicas en tokens.
Skill:writing-for-agentsÁrea:Productividad
8. Ocho consejos prácticos
1. Saltarse el interrogatorio es el mayor errorInterrogatorio · Glosario"Nadie sabe exactamente qué quiere" (The Pragmatic Programmer). Incluso al pedir un simple redimensionador de imágenes, usa /grill-with-docs para definir tamaño máximo, proporción y subida múltiple antes de programar.
2. Invierte en GLOSSARY.mdInterrogatorio · GlosarioDocumentar ADRs y términos del dominio acorta las conversaciones largas y mantiene coherentes los nombres de funciones y archivos.
3. Los bucles de feedback marcan tu velocidadFeedback · EstructuraTipos estáticos, acceso al navegador y tests automáticos forman tu red de seguridad; tdd automatiza el ritmo rojo → verde → refactor.
4. Ejecuta /improve-codebase-architecture periódicamenteFeedback · EstructuraLa IA acumula deuda técnica al mismo ritmo que genera código. Revisa el informe HTML cada pocos días y lleva un candidato elegido a sesión de interrogatorio.
5. Cierra cada sesión con /retroDocs · PersonalizaciónDetectar comandos de test faltantes o reglas ambiguas al final de cada jornada produce mejoras acumulativas en tu flujo.
6. Usa /handoff y /wait-what sin miedoDocs · PersonalizaciónSi el chat se alarga, comprímelo con /handoff para seguir en una sesión limpia; si no entiendes una explicación del agente, lanza /wait-what al instante.
7. Escribe tus docs con writing-for-agentsDocs · PersonalizaciónCambia párrafos largos en CLAUDE.md por órdenes directas como 'Tests: npx vitest run. Ejecutar antes de cada commit.' Una línea clara vale más que un skill extra.
8. Los skills son tuyos: edítalos librementeDocs · PersonalizaciónTodos son archivos de texto plano. Pide al agente que te muestre cualquier SKILL.md y recorta preguntas o ajusta reglas a tu equipo.
9. Combinarlo con Caveman y Ponytail
Tal como vimos en nuestra Guía de Caveman y Ponytail, mattpocock/skills encaja sin solapamientos formando una pila de tres capas:
| Capa | Herramienta | Qué controla |
|---|---|---|
| Procedimiento (qué y cuándo) | mattpocock/skills | Impone el orden interrogatorio → spec → tickets → TDD → revisión |
| Conversación (tokens por paso) | Caveman | Acorta respuestas y comprime logs/salidas (npx @caveman-ai/cli@latest) |
| Código (tamaño del resultado) | Ponytail | Aplica la escalera de 7 pasos (AGENTS.md recomendado) |
Orden recomendado de integración
- Base permanente con Caveman — acorta el intercambio en
/grill-with-docsy comprime logs y salidas de tests que lee/implement(hasta 33% menos tokens de entrada medidos). - Ponytail en fase de código — copia las reglas de Ponytail en tu
AGENTS.mdgestionado conwriting-for-agents; su filosofía encaja de lleno contddycode-review. - Separa momentos de revisión — usa
/code-reviewantes de hacer commit (estándares + fidelidad a la spec) y/ponytail-reviewuna sola vez justo antes del PR (bugs, seguridad y código sobrante) para no pagar dos veces. - Comprueba resultados en paralelo — contrasta
/ponytail banden Claude Code concaveman statsen terminal para separar mejoras de calidad frente a ahorro real de tokens.
Comandos esenciales (clic para copiar)
Flujo principal de mattpocock/skills
Ayuda rápida y combinación en 3 capas
10. Preguntas frecuentes (FAQ)
P1. ¿En qué se diferencia de GSD, BMAD o Spec-Kit?
P2. ¿No vuelve esto demasiado lento el vibe coding?
P3. ¿En qué agente funciona mejor?
P4. ¿Cómo se actualizan los skills?
P5. ¿Cuántos skills incluye exactamente?
P6. Instalé el plugin y skills.sh a la vez y me salen duplicados.
P7. ¿Puedo adaptar los skills a mi estilo?
Valida la configuración JSON de Copilot y agentes con Hafuture
Formatea y comprueba ~/.copilot/settings.json (extraKnownMarketplaces) o archivos JSON de plugins al instante en tu navegador—100% privado.