mattpocock/skills: las skills que Matt Pocock usa cada día con su agente
mattpocock/skills es el repositorio donde Matt Pocock publica las skills que usa a diario con sus agentes de código: grilling, specs, tickets, TDD, diagnóstico de bugs, code review y handoff. Se instala como plugin de Claude Code o con npx skills add mattpocock/skills en cualquier otro agente, y tiene licencia MIT.
Más de 275.000 estrellas por una carpeta. Matt Pocock, el de Total TypeScript (antes pasó por Vercel y Stately), no lanzó un framework. Subió lo que tiene en su directorio .agents, y la descripción del repo lo dice tal cual: "Straight from my .agents directory".
Qué es mattpocock/skills
El README se presenta como "Skills For Real Engineers" y se posiciona contra los frameworks que se adueñan del proceso: nombra a GSD, BMAD y Spec-Kit, y dice que al hacerlo te quitan el control y hacen difícil arreglar los fallos del propio proceso. Su alternativa son skills pequeñas, fáciles de adaptar y que se componen entre sí.
El repo se creó el 3 de febrero de 2026. GitHub lo marca como Shell y JavaScript porque no cuenta el Markdown, pero lo que hay dentro son archivos SKILL.md; el código son los scripts de mantenimiento y algún template.
Las skills viven en carpetas por categoría:
engineering/: trabajo de código diario.productivity/: flujo de trabajo que no es código.misc/: se conservan, pero casi no las usa.in-progress/: beta, públicas a propósito para recibir feedback, fuera del plugin.deprecated/: ya no las usa.
Solo engineering/ y productivity/ entran en el plugin. El plugin.json de la versión 1.3.1 lista 27 skills.
Qué skills trae
El README las divide por quién puede invocarlas. Las user-invoked solo arrancan cuando tú escribes el comando y orquestan el trabajo. Las model-invoked también las puede llamar el agente solo cuando la tarea encaja, y guardan la disciplina reutilizable. Una user-invoked puede llamar a una model-invoked, nunca a otra user-invoked.
| Problema | Skills |
|---|---|
| Alinearte con el agente antes de empezar | grill-me, grill-with-docs, grilling |
| Pasar de la conversación a trabajo concreto | to-spec, to-tickets, wayfinder, triage |
| Construir | implement, implement-spec, tdd, prototype |
| Bugs | diagnosing-bugs |
| Revisar y cerrar | code-review, pr, retro |
| Diseño del código | codebase-design, improve-codebase-architecture, domain-modeling |
| Continuar en otra sesión | handoff |
| Saber cuál usar | ask-matt |
ask-matt es un router: le cuentas lo que tienes entre manos y te dice qué skill o qué flujo encaja. El flujo principal que describe va de idea a entrega: /grill-with-docs para afinar la idea, /to-spec y /to-tickets si es un trabajo de varias sesiones, /implement con /tdd y /code-review, y /retro al final.
Cómo instalar las skills de Matt Pocock
El README plantea dos caminos con dos filosofías distintas, y pide elegir uno: instalar los dos te deja cada skill duplicada.
En Claude Code, como plugin
claude plugins install mattpocock-skillsO desde una sesión:
/plugin install mattpocock-skills
Está en el marketplace oficial de Claude Code, así que no hay que añadir nada antes, y se actualiza solo. Es un paquete de solo lectura: te suscribes a lo que Matt publica y lo recibes tal cual. Si no conoces el formato, en plugins de Claude Code explico cómo funcionan.
En Codex, Cursor y otros agentes, con npx skills
npx skills@latest add mattpocock/skillsEl instalador te deja elegir qué skills llevarte y en qué agentes instalarlas. Escribe las skills en tu repo como archivos normales que son tuyos: nada se actualiza sin que lo pidas, y cuando quieres lo último de Matt corres npx skills update. Este camino también sirve en Claude Code. Más sobre la herramienta en npx skills.
Elijas el que elijas, incluye setup-matt-pocock-skills. El README lo pide en negrita.
/setup-matt-pocock-skills: un setup por repo
Se corre una vez por repositorio, antes de usar las skills de ingeniería. Configura tres cosas y las deja escritas en docs/agents/, con un bloque ## Agent skills en tu CLAUDE.md o AGENTS.md:
- El issue tracker, donde
to-tickets,triageyto-specleen y escriben. - Las etiquetas de triage, solo si tienes
triageinstalada. Las cinco por defecto sonneeds-triage,needs-info,ready-for-agent,ready-for-humanywontfix. - Dónde viven los docs de dominio: un
GLOSSARY.mdydocs/adr/en la raíz, o uno por paquete si es un monorepo.
Sobre el tracker, el README y la skill no dicen lo mismo. El README habla de GitHub, Linear o archivos locales. El SKILL.md trae plantillas para GitHub, GitLab y Markdown local en .scratch/; Linear y Jira entran como "otro", y la skill te pide que describas tu flujo en un párrafo. Lo que manda es la skill.
No la uses tal cual: forkéala
Las opiniones de este repo son de Matt, y por eso hay que adaptarlo. ask-matt enruta el flujo de Matt, no el tuyo. El flujo de tickets asume una forma de trabajar (tickets con bloqueos explícitos, un /clear entre ticket y ticket) que puede no ser la de tu equipo.
El propio README lo pide: "Hack around with them. Make them your own." El camino para eso es npx skills add, que deja los archivos en tu repo. El plugin es para quien quiere el set de Matt exactamente como él lo usa.
Yo tengo ocho instaladas con npx skills: code-review, tdd, grilling, writing-for-agents, diagnosing-bugs, codebase-design, domain-modeling y wizard. No toqué ninguna. Todas son model-invoked, de las que guardan una disciplina general (cómo testear, cómo revisar un diff, cómo escribir para un agente) y encajan en cualquier repo. Con writing-for-agents escribo mis propias skills, las que publico en abr4xas/skills. Esa es la línea que trazaría: la disciplina de Matt se puede usar tal cual, pero su flujo hay que reemplazarlo por el tuyo.
Lo que vale la pena leer
El valor no está en copiar y pegar. Está en ver cómo un ingeniero con oficio le habla a su agente.
grill-me, una de las más instaladas, tiene una sola línea de cuerpo:
Call the Skill tool with "grilling".Toda la lógica está en grilling, la skill model-invoked que también usan grill-with-docs, triage, wayfinder e improve-codebase-architecture. grilling define un árbol de decisiones, una frontera de preguntas que ya se pueden hacer sin adivinar respuestas, rondas numeradas con una respuesta recomendada en cada una, y un criterio de cierre claro: la sesión termina cuando la frontera queda vacía. También separa los papeles: buscar hechos es trabajo del agente, decidir es trabajo tuyo.
La otra lectura obligada es la sección "Why These Skills Exist" del README. Ordena las skills por el fallo que corrigen: el agente no hizo lo que querías, el agente es demasiado verboso, el código no funciona, construimos una bola de barro. Para la verbosidad propone un glosario compartido con el agente, y da este ejemplo de su repo course-video-manager: "There's a problem when a lesson inside a section of a course is made 'real'" se convierte en "There's a problem with the materialization cascade".
Si escribes tus propias skills, en skills de Claude Code está cómo se arman desde cero.
Preguntas frecuentes
¿Qué es mattpocock/skills?
Un repositorio de skills para agentes de código que Matt Pocock usa a diario: grilling, specs, tickets, TDD, diagnóstico de bugs, code review, handoff y diseño de código. Funciona en Claude Code, Codex y otros agentes compatibles con el estándar de skills.
¿Cómo instalo las skills de Matt Pocock en Claude Code?
Con claude plugins install mattpocock-skills, o /plugin install mattpocock-skills desde una sesión. Si prefieres archivos editables en tu repo, usa npx skills@latest add mattpocock/skills. No instales las dos cosas: duplicarías cada skill.
¿Qué hace /setup-matt-pocock-skills?
Configura el repo para las skills de ingeniería: el issue tracker (GitHub, GitLab, Markdown local u otro), las etiquetas de triage y la ubicación de GLOSSARY.md y los ADR. Se corre una vez por repo.
¿Qué es grill-me?
Una skill que hace que el agente te entreviste sin descanso sobre un plan o un diseño hasta resolver cada rama de decisiones. Es una de las skills más instaladas del repo, y por dentro solo llama a grilling.
¿Qué licencia tiene mattpocock/skills?
MIT, con copyright de Matt Pocock de 2026.
¿Funcionan con Cursor o Codex?
Sí, a través de npx skills add, que instala las skills en el agente que elijas. El plugin nativo es solo para Claude Code; un plugin de Codex está pospuesto porque su manifest no permite seleccionar un subconjunto de carpetas, según el ADR 0002 del repo.
Fuentes
¿Tienes un proyecto en mente?
Trabajo con Laravel, WordPress, SEO técnico y servidores MCP. El primer paso es una llamada de descubrimiento, sin costo ni compromiso, donde me cuentas qué necesitas y te digo con honestidad si puedo ayudarte.