Las skills de Matt Pocock: cómo instalarlas en Claude Code y Codex, y para qué sirven

mattpocock/skills es la colección de skills que Matt Pocock usa a diario para programar con agentes, publicada tal cual desde su carpeta de trabajo. Se instala en Claude Code con claude plugins install mattpocock-skills y en Codex con npx skills@latest add mattpocock/skills. Es MIT, y a día de hoy es el repositorio de skills con más estrellas de GitHub.

Lo interesante no es el número. Es que su enfoque va justo en contra de lo que vende casi todo el mundo.

Aviso antes de seguir: aquí no hay capturas de pantalla que enseñar, y no es un descuido. Este repo no tiene interfaz: son archivos de texto que tu agente lee. Lo que cambia no se ve en una ventana, se nota en cómo responde el agente. Es justo el malentendido que más aleja a la gente de las skills.

La idea de fondo: menos automatización, no más

Hay una familia entera de herramientas —GSD, BMAD, Spec-Kit— que intentan ayudarte adueñándose del proceso: te imponen un flujo de trabajo completo. El argumento de Matt Pocock contra eso es sencillo y difícil de rebatir: cuando el proceso es una caja negra, los fallos dentro del proceso son imposibles de arreglar. Ganas automatización y pierdes control.

Sus skills van al revés: pequeñas, fáciles de adaptar y combinables. Funcionan con cualquier modelo. Y están pensadas para que las abras, las modifiques y las hagas tuyas, no para que te suscribas a ellas.

Es una diferencia de filosofía que se nota en el primer uso.

El fallo que atacan: "el agente no ha hecho lo que le pedí"

El diagnóstico que da el repo es el más certero que he leído sobre trabajar con agentes: el problema no es la capacidad del modelo, es el desajuste entre lo que tú crees que has pedido y lo que has pedido de verdad. Es exactamente el mismo fallo que lleva décadas hundiendo proyectos de software entre humanos, solo que ahora ocurre en treinta segundos en vez de en tres meses.

Y la solución que propone es contraintuitiva: en vez de que el agente empiece antes, que te interrogue primero.

De ahí salen sus dos skills más usadas:

• /grill-me — el agente te somete a un interrogatorio detallado sobre lo que quieres antes de tocar nada.
• /grill-with-docs — lo mismo, pero apoyándose además en documentación.

La primera vez que lo usas la sensación es rara, porque parece que estás perdiendo el tiempo respondiendo preguntas en lugar de recibir código. Al tercer uso te das cuenta de que las preguntas que te hace son las que tú no te habías hecho.

Cómo instalarlo en Claude Code

Dos caminos, y hay que elegir uno:

claude plugins install mattpocock-skills

O desde dentro de 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 las actualizaciones llegan solas. Este camino instala el conjunto como un paquete gestionado de solo lectura: te suscribes a los cambios del autor en lugar de bifurcarlos.

Cómo instalarlo en Codex

npx skills@latest add mattpocock/skills

El instalador te deja elegir qué skills quieres y para qué agentes. Y aquí está el detalle que más gente se salta:

Asegúrate de incluir setup-matt-pocock-skills entre las que instalas.

Sin esa, el paso siguiente no existe y la mitad del conjunto no funciona. El repo avisa de que un plugin nativo para Codex está en su hoja de ruta, así que por ahora esta es la vía.

Este camino escribe las skills en tu repositorio como archivos normales que son tuyos y puedes editar. Nada se actualiza a tus espaldas; cuando quieras sus cambios, npx skills update.

El paso que casi todo el mundo se salta

Una vez instalado, hay que ejecutar esto una vez por repositorio:

/setup-matt-pocock-skills

Te va a preguntar tres cosas: qué gestor de incidencias usas (GitHub, Linear o archivos locales), qué etiquetas pones cuando clasificas tickets, y dónde quieres que se guarde la documentación que se genere.

Si te lo saltas, varias skills no tienen a dónde escribir ni de dónde leer, no hacen nada, y concluyes que el repo está sobrevalorado. No lo está: te falta el paso de configuración.

El error de instalación más común

No instales el plugin y además la versión con npx. Son dos filosofías distintas y el repo lo advierte expresamente: te quedas con cada skill duplicada y con un agente que no sabe a cuál hacer caso.

Elige según lo que quieras: plugin si prefieres que se actualice solo y no tocar nada, instalador si quieres abrir los archivos y adaptarlos a tu forma de trabajar.

Aplicaciones prácticas fuera de programar

Aquí va lo que más me interesa a mí de este repo, y que no se comenta: /grill-me no es una skill de programación. Es una skill de definición de requisitos, y funciona igual de bien si lo que vas a encargar es una campaña, un plan de contenidos o la especificación de un informe.

Yo la uso antes de encargar cualquier cosa larga a un agente. El patrón es siempre el mismo: crees que tienes claro lo que quieres hasta que alguien te hace diez preguntas concretas. La diferencia entre un encargo de una línea y uno bien definido es la diferencia entre tirar el resultado y usarlo.

Si te interesa esa parte, va en la misma línea que lo que cuento sobre cómo escribir buenos prompts: el cuello de botella casi nunca es el modelo.

Cuándo no te compensa

• Si buscas automatización total, este repo va justo en la dirección contraria a propósito.
• Si no vas a leer las skills, pierdes la mitad del valor: están escritas para adaptarse.
• Si tu flujo ya está montado sobre otro framework de agentes, mezclar los dos suele dar instrucciones contradictorias. Elige uno.
• Son opiniones de ingeniería concretas, no verdades universales. Están pensadas para desarrollo de software real; si tu trabajo se parece poco a eso, algunas te van a sobrar.

Preguntas frecuentes

¿Qué son exactamente estas skills?

Archivos de instrucciones que tu agente carga cuando hacen falta y que cambian cómo aborda una tarea concreta. No son programas: no hay nada que abrir ni ninguna interfaz. Se nota cuando le pides al agente el tipo de trabajo que cubren.

¿Funcionan con Codex o solo con Claude Code?

Con los dos. En Claude Code hay plugin oficial con actualizaciones automáticas; en Codex se instalan con npx skills@latest add mattpocock/skills. El propio repo dice que el plugin nativo de Codex está en su hoja de ruta.

¿Por qué no me funciona ninguna skill después de instalar?

Casi siempre es porque falta ejecutar /setup-matt-pocock-skills en el repositorio, o porque no se instaló esa skill de configuración cuando el instalador te dejó elegir. Es el fallo más habitual con diferencia.

¿Puedo modificarlas?

Sí, y es la intención declarada del autor: están pensadas para que las adaptes. Si quieres editarlas, instala con el instalador en vez de con el plugin, porque el plugin las mantiene como paquete de solo lectura.

¿Sirven si no programo?

Algunas sí. /grill-me, que fuerza al agente a interrogarte antes de empezar, funciona igual de bien para definir cualquier encargo complejo. La mayoría de las demás sí están atadas al desarrollo de software.