hafuture

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.

AIVibe CodingClaude CodeCodexCursorMatt PocockDeveloper ToolsTDD

Índice


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:

FalloSíntoma habitualSkill que lo resuelve
1. No construye lo que queríasCreí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 verbosoUsa 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 funcionaLa 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

bash
claude plugin install mattpocock-skills@claude-plugins-official
Se actualiza automáticamente por defecto.

3.2 Una sola vez por repositorio: /setup-matt-pocock-skills

Ejecuta /setup-matt-pocock-skills dentro del chat del agente y responde tres preguntas:

  1. Qué gestor de incidencias usas (GitHub, GitLab, archivos locales o tu flujo propio)
  2. Etiquetas de clasificación (usadas por /triage)
  3. Dónde guardar la documentación (especificaciones, GLOSSARY.md y 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:

  1. 1
    Alinear el rumbo — Interrogatorio de diseño/grill-with-docs

    El agente te pregunta cada bifurcación del diseño mientras construye automáticamente GLOSSARY.md y los registros ADR.

  2. 2
    Consolidar la especificación — Sin preguntas redundantes/to-spec

    Resume toda la conversación en una especificación limpia y la publica en el gestor elegido durante el setup.

  3. 3
    Dividir en tickets — Trazas verticales con dependencias/to-tickets

    Parte la especificación en tickets tracer-bullet (modelo → vista de hoy → completar/posponer) marcando qué ticket bloquea a cuál.

  4. 4
    Implementar — Tests primero y revisión automática/implement

    Programa ticket por ticket ejecutando ciclos tdd (rojo → verde → refactor) y lanza code-review antes de cada commit.

  5. 5
    Revisión paralela en dos ejes — Estándares + Especificación/code-review

    Dos subagentes independientes revisan en paralelo reglas de código/olores de Fowler y cumplimiento estricto de la especificación.

  6. 6
    Redactar PR — Resumen visual, pruebas y riesgo de fusión/pr

    Genera el cuerpo del Pull Request con evidencia antes/después, resumen visual mínimo y análisis de reversibilidad.

  7. 7
    Retrospectiva — Mejora continua del entorno del agente/retro

    Al cerrar la sesión, propone mejoras priorizadas por severidad en tus checks automáticos, reglas y herramientas.

Ejemplo real del paso 1

Ejemplo de inicio (/grill-with-docs)
/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

Elige el flujo según tu situación actual
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:

Catálogo completo de los 27 skills27 skills
  • 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 · Glosario

Documentar 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 · Estructura

Tipos 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 · Estructura

La 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ón

Detectar 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ón

Si 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ón

Cambia 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ón

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

CapaHerramientaQué controla
Procedimiento (qué y cuándo)mattpocock/skillsImpone el orden interrogatorio → spec → tickets → TDD → revisión
Conversación (tokens por paso)CavemanAcorta respuestas y comprime logs/salidas (npx @caveman-ai/cli@latest)
Código (tamaño del resultado)PonytailAplica la escalera de 7 pasos (AGENTS.md recomendado)

Orden recomendado de integración

  1. Base permanente con Caveman — acorta el intercambio en /grill-with-docs y comprime logs y salidas de tests que lee /implement (hasta 33% menos tokens de entrada medidos).
  2. Ponytail en fase de código — copia las reglas de Ponytail en tu AGENTS.md gestionado con writing-for-agents; su filosofía encaja de lleno con tdd y code-review.
  3. Separa momentos de revisión — usa /code-review antes de hacer commit (estándares + fidelidad a la spec) y /ponytail-review una sola vez justo antes del PR (bugs, seguridad y código sobrante) para no pagar dos veces.
  4. Comprueba resultados en paralelo — contrasta /ponytail band en Claude Code con caveman stats en terminal para separar mejoras de calidad frente a ahorro real de tokens.

Comandos esenciales (clic para copiar)

Haz clic en cualquier comando para copiarlo

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?
Los marcos monolíticos controlan todo el proceso; si un paso falla, arreglarlo cuesta mucho. mattpocock/skills son 27 piezas pequeñas y componibles: si el interrogatorio te parece largo, editas directamente las preguntas del archivo grilling.
P2. ¿No vuelve esto demasiado lento el vibe coding?
El objetivo no es frenarte, sino detectar errores al instante con tipos estáticos, navegador y TDD mientras /grill-with-docs y /improve-codebase-architecture evitan que el proyecto colapse.
P3. ¿En qué agente funciona mejor?
Es agnóstico al modelo. La instalación por plugin (Claude Code, Codex, Copilot) es la más cómoda por sus actualizaciones automáticas; en Cursor, OpenCode o Windsurf se instala con npx skills@latest add mattpocock/skills -a <agent>.
P4. ¿Cómo se actualizan los skills?
Claude Code actualiza solo, Codex al iniciar, Copilot CLI con autoUpdate: true y VS Code cada día. En Gemini CLI basta repetir el comando de instalación, y con npx skills se usa npx skills@latest update (o add si hay skills nuevos).
P5. ¿Cuántos skills incluye exactamente?
27 en total: 16 manuales (11 de ingeniería + 5 de productividad) y 11 automáticos (9 de ingeniería + 2 de productividad), todos publicados como SKILL.md legibles bajo skills/engineering/ y skills/productivity/.
P6. Instalé el plugin y skills.sh a la vez y me salen duplicados.
Deja solo uno por agente. Para conservar el plugin automático ejecuta npx skills remove mattpocock/skills; si prefieres las copias editables, elimina mattpocock-skills desde /plugin y verifica en una nueva sesión que /ask-matt aparezca una sola vez.
P7. ¿Puedo adaptar los skills a mi estilo?
Sí, el lema del repositorio es 'Hack around with them. Make them your own'. Pide a tu agente que abra cualquier archivo SKILL.md y ajústalo. Solo recuerda incluir setup-matt-pocock-skills si instalas de forma manual.

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.

Abrir Formateador JSON