Skills de Matt Pocock para Claude Code: qué son, cómo instalarlas y por cuál empezar

Las skills de Matt Pocock son un paquete de 27 instrucciones para agentes de programación (Claude Code, Codex, GitHub Copilot, Gemini CLI, Cursor y otros) que atacan los fallos típicos de trabajar con IA: el agente no entiende lo que quieres, habla con demasiada jerga, entrega código que no funciona y deja el proyecto convertido en una bola de barro. Las publica Matt Pocock, conocido por sus cursos de TypeScript, en el repositorio mattpocock/skills con licencia MIT.

Esta es la primera parte de una guía de 14 artículos. Aquí ves qué hay en el repositorio, cómo instalarlo, cómo se organiza y el flujo de trabajo que propone. En los siguientes artículos repasamos las skills por parejas que se complementan, con dos dedicados a la más popular: grill-me.

Si es la primera vez que oyes hablar de skills, lee antes la guía de skills de Claude Code.

Qué son las skills de Matt Pocock

El README las presenta como "skills para ingenieros de verdad, no para vibe coding". La idea de fondo es una crítica a los frameworks que se adueñan de todo el proceso (cita a GSD, BMAD y Spec-Kit): te quitan el control y hacen que los fallos del propio proceso sean difíciles de arreglar. Estas skills son pequeñas, fáciles de adaptar y componibles: cada una hace una cosa y unas llaman a otras.

Datos comprobados en el repositorio:

Los cuatro problemas que intenta resolver

El README organiza todo el repositorio alrededor de cuatro fallos. Merece la pena tenerlos en la cabeza, porque cada skill de la guía responde a uno de ellos:

1. El agente no hizo lo que querías. Hay un hueco de comunicación entre tú y el agente. La solución es una sesión de interrogatorio antes de empezar: grill-me y grill-with-docs.
2. El agente es demasiado verboso. Usa 20 palabras donde basta una porque no conoce la jerga del proyecto. La solución es un lenguaje compartido escrito en un GLOSSARY.md: domain-modeling.
3. El código no funciona. Al agente le faltan bucles de feedback: tipos, navegador y tests. La solución es tdd (rojo-verde) y diagnosing-bugs para los fallos difíciles.
4. Hemos construido una bola de barro. Los agentes aceleran la entropía del código. La solución es cuidar el diseño: codebase-design e improve-codebase-architecture.

Cómo instalar las skills

El README da un comando por agente. Elige una vía por agente: si instalas el plugin y además copias los ficheros con npx skills, tendrás cada skill dos veces.

Claude Code (se actualiza solo):

claude plugin install mattpocock-skills@claude-plugins-official

Codex:

codex plugin marketplace add mattpocock/skills
codex plugin add mattpocock-skills@mattpocock

GitHub Copilot (CLI):

copilot plugin marketplace add mattpocock/skills
copilot plugin install mattpocock-skills@mattpocock

Gemini CLI (actualización manual, repite los dos comandos para actualizar):

gemini skills install https://github.com/mattpocock/skills.git --path skills/engineering
gemini skills install https://github.com/mattpocock/skills.git --path skills/productivity

Cualquier otro agente (Cursor, OpenCode, Windsurf, Amp...) o si quieres ficheros que puedas editar:

npx skills@latest add mattpocock/skills -a cursor

Con el plugin de Claude Code las skills llevan el prefijo del plugin: se invocan como /mattpocock-skills:grill-me. Si las copias con npx skills, quedan como /grill-me. Para buscar y comparar otros paquetes de skills tienes find-skills.

La pareja de arranque: setup-matt-pocock-skills y ask-matt

Las dos primeras skills que debes usar no escriben código. Una prepara el repositorio y la otra te dice qué skill toca en cada momento.

setup-matt-pocock-skills: configurar el repositorio una vez

Las skills de ingeniería asumen tres cosas sobre tu proyecto: dónde viven los issues, qué etiquetas usas para clasificarlos y dónde se guardan el glosario y las decisiones. /setup-matt-pocock-skills lo pregunta una vez por repositorio:

• Issue tracker: GitHub (con el CLI gh), GitLab (con glab), Markdown local en .scratch/<feature>/ o cualquier otro que describas en un párrafo (Jira, Linear...).
• Etiquetas de triage: solo si tienes instalada la skill triage. Por defecto son needs-triage, needs-info, ready-for-agent, ready-for-human y wontfix.
• Documentos de dominio: un único GLOSSARY.md y docs/adr/ en la raíz (lo normal), o un GLOSSARY-MAP.md si es un monorepo con varios contextos.

No es un script: explora el repositorio (git remote -v, CLAUDE.md, docs/adr/, .scratch/), te enseña lo que encontró, te pide confirmación sección por sección y luego escribe. El resultado es un bloque ## Agent skills en tu CLAUDE.md (o AGENTS.md, nunca crea uno si ya existe el otro) y tres ficheros en docs/agents/:

docs/agents/
├── issue-tracker.md   # cómo crear y leer issues
├── triage-labels.md   # solo si usas /triage
└── domain.md          # dónde viven GLOSSARY.md y los ADR

Si trabajas solo y no quieres issues en GitHub, elige Markdown local: los specs y tickets quedan como ficheros en .scratch/, versionados con el código.

ask-matt: el router que te dice qué skill usar

Nadie recuerda 27 skills. /ask-matt es un "router": le describes tu situación y te dice qué flujo seguir. Lo útil es que su SKILL.md contiene el mapa completo de cómo encajan las piezas:

• Flujo principal (idea → envío): grill-with-docs para afinar la idea, to-spec y to-tickets si el trabajo ocupa varias sesiones, implement (que usa tdd y cierra con code-review) y retro al final.
• Rampas de entrada: triage cuando se acumulan bugs y peticiones, diagnosing-bugs cuando algo está roto y wayfinder cuando el proyecto es enorme y está lleno de niebla.
• Salud del código: improve-codebase-architecture cuando tengas un rato libre.
• Vocabulario de fondo: domain-modeling y codebase-design, que otras skills cargan por debajo.
• Sueltas: grill-me, prototype, research, to-questionnaire, wizard, wait-what, teach y writing-for-agents.

Juntas son la pareja de arranque: setup deja el repositorio listo y ask-matt te orienta cuando no sabes por dónde seguir.

Skills que invocas tú y skills que invoca el agente

El repositorio separa las skills por quién puede invocarlas:

• Invocadas por el usuario (disable-model-invocation: true en Claude Code): solo se ejecutan cuando escribes /nombre. Orquestan procesos: grill-me, to-spec, implement, retro...
• Invocadas por el modelo: el agente las carga solo cuando la tarea encaja, y también puedes llamarlas tú. Guardan la disciplina reutilizable: tdd, grilling, code-review, codebase-design...

La regla de composición es sencilla: una skill de usuario puede llamar a skills del modelo, pero nunca a otra skill de usuario. Por eso grill-me tiene una sola línea ("llama a la skill grilling") y implement delega en tdd y code-review.

Lo que el plugin no instala

Hay dos carpetas fuera del plugin:

• misc/: skills que el autor usa poco, como git-guardrails-claude-code (hooks que bloquean git push, reset --hard o clean), setup-pre-commit (Husky + lint-staged) o migrate-to-shoehorn.
• in-progress/: skills beta que pueden cambiar o desaparecer, como loop-me, claude-handoff o software-factory. Se instalan una a una con npx skills@latest add mattpocock/skills --skill=<nombre>.

Esta guía cubre las 27 del plugin.

Gestión del contexto: cuándo limpiar la sesión

Uno de los consejos más útiles del repositorio no es una skill, sino una regla de ask-matt: mantén el interrogatorio, el spec y los tickets en la misma ventana de contexto, sin compactar hasta después de to-tickets, porque cada paso se apoya en el razonamiento literal del anterior. Después, cada implement puede empezar limpio desde su ticket.

El límite lo pone lo que el autor llama la "smart zone": unos 150.000 tokens en los modelos actuales, a partir de los cuales el modelo razona peor. En la frontera entre fases te da cinco opciones en este orden: continuar, /clear, /handoff, un subagente o /compact. /compact es la opción por defecto, pero la última que deberías considerar.

Errores frecuentes al empezar

• Instalar por dos vías. Plugin y npx skills a la vez duplican todas las skills.
• Saltarse /setup-matt-pocock-skills. to-spec, to-tickets, triage y code-review te devolverán un "ejecuta primero el setup" si no saben dónde está el issue tracker.
• Esperar que las skills de usuario salten solas. grill-me o to-spec no se activan aunque la tarea encaje: hay que escribir el comando.
• Confundir grill-me con grill-with-docs. Hacen el mismo interrogatorio, pero la segunda escribe glosario y ADR. Si trabajas dentro de un repositorio, el autor recomienda siempre la segunda.

Preguntas frecuentes

¿Son gratis? Sí. Licencia MIT: puedes usarlas, modificarlas y redistribuirlas, también en proyectos comerciales, manteniendo el aviso de copyright.

¿Funcionan con cualquier modelo? El README dice que sí. Nosotros probamos grill-me y grill-with-docs con Claude Code 2.1.316 y Sonnet 5.5; el resto de skills de esta guía las revisamos desde su código fuente.

¿En qué se diferencian de Superpowers? Superpowers impone un proceso completo con un hook que se carga en cada sesión. Las de Matt Pocock no traen hooks: tú decides qué skill usar y cuándo.

¿Están en español? No, los SKILL.md están en inglés, pero el agente te responde en el idioma en que le escribes. En nuestras pruebas todo el interrogatorio salió en español.

Siguiente paso

Instala el plugin, ejecuta /setup-matt-pocock-skills en tu proyecto y pasa a la siguiente parte de la guía: grill-me, la skill más popular del repositorio, explicada a fondo y probada en una sesión real de cuatro rondas.