--- title: "mattpocock/skills: las skills que Matt Pocock usa cada día con su agente" excerpt: "Más de 275.000 estrellas para una carpeta de skills. Qué trae el repo de Matt Pocock, cómo se instala en Claude Code o con npx skills, y por qué conviene forkearlo en vez de usarlo tal cual." date: "2026-10-05T01:00:00.000Z" category: "Claude Code" tech_article: true author: name: "angel cruz" picture: "/images/me/angel-cruz.png" ogImage: url: "/images/posts/mattpocock-skills/mattpocock-skills.png" seo_title: "Matt Pocock skills: qué trae mattpocock/skills y cómo instalarlo" seo_description: "Las skills de Matt Pocock para Claude Code y otros agentes: grill-me, tdd, code-review, to-tickets, handoff. Cómo instalarlas y por qué forkearlas." --- **`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 ```bash claude plugins install mattpocock-skills ``` O 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](/post/plugins-claude-code) explico cómo funcionan. ### En Codex, Cursor y otros agentes, con npx skills ```bash npx skills@latest add mattpocock/skills ``` El 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](/post/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`: 1. El issue tracker, donde `to-tickets`, `triage` y `to-spec` leen y escriben. 2. Las etiquetas de triage, solo si tienes `triage` instalada. Las cinco por defecto son `needs-triage`, `needs-info`, `ready-for-agent`, `ready-for-human` y `wontfix`. 3. Dónde viven los docs de dominio: un `GLOSSARY.md` y `docs/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](https://github.com/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: ```markdown 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](/post/skills-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 - [mattpocock/skills en GitHub](https://github.com/mattpocock/skills) - [README.md](https://github.com/mattpocock/skills/blob/main/README.md) - [plugin.json](https://github.com/mattpocock/skills/blob/main/.claude-plugin/plugin.json) - [setup-matt-pocock-skills/SKILL.md](https://github.com/mattpocock/skills/blob/main/skills/engineering/setup-matt-pocock-skills/SKILL.md) - [grilling/SKILL.md](https://github.com/mattpocock/skills/blob/main/skills/productivity/grilling/SKILL.md) - [ADR 0002: Ship as a Claude Code plugin](https://github.com/mattpocock/skills/blob/main/.agents/adr/0002-ship-as-a-claude-code-plugin.md) - [mattpocock/skills en skills.sh](https://skills.sh/mattpocock/skills) - [README de vercel-labs/skills, el CLI de npx skills](https://github.com/vercel-labs/skills) - [AI Hero](https://www.aihero.dev/) --- ## Sitemap Índice completo del sitio: [/sitemap.md](https://www.angelcruz.dev/sitemap.md) Canónico HTML: [https://www.angelcruz.dev/post/mattpocock-skills](https://www.angelcruz.dev/post/mattpocock-skills)