Mattpocock/skills: El .claude de un Ingeniero Real, Ahora en tu Directorio

La mayoría de los devs que usan Claude Code escriben sus instrucciones desde cero — o directamente no escriben ninguna. Matt Pocock acaba de publicar su directorio .claude completo para que no tengas que hacerlo.

mattpocock/skills es una colección de skills para Claude Code. Llegó al #1 de GitHub Trending y está en 75.7K estrellas. La descripción del repo lo dice sin vueltas: “Skills for Real Engineers.” No es marketing — es un contraste deliberado con el vibe coding, donde describís lo que querés y esperás que el modelo lo resuelva.

Cada skill de esta colección hace exactamente una cosa.


Qué tiene la colección

Los skills están organizados en cuatro áreas:

Planificación y diseño — antes de tocar una línea de código:

  • write-a-prd — Corre una entrevista interactiva, explora tu codebase y archiva el PRD resultante directamente como un issue de GitHub.
  • prd-to-issues — Toma ese PRD y lo parte en issues de GitHub independientes, cortados en slices verticales.
  • grill-me — Te interroga sobre tu plan hasta que cada rama del árbol de decisión queda resuelta. Útil cuando sabés lo que querés construir pero todavía no lo pensaste del todo.

Desarrollo — escribir, refactorizar, arreglar:

  • tdd — Loop red-green-refactor. Construye features o arregla bugs de a un slice vertical por vez. Este es el skill central de la colección — TDD primero es innegociable en el workflow de Pocock.
  • triage-issue — Investiga un bug explorando el codebase, identifica la causa raíz y archiva un issue de GitHub con un plan de fix basado en TDD. Debugging estructurado, no vibear hasta que algo compila.
  • improve-codebase-architecture — Busca oportunidades de mejora arquitectónica: módulos superficiales, gaps de testabilidad, candidatos a slice vertical.

Tooling y setup:

  • setup-pre-commit — Configura hooks de pre-commit con Husky, lint-staged, Prettier, type checking y tests.
  • git-guardrails-claude-code — Configura hooks de Claude Code para bloquear comandos git peligrosos (push a main, reset --hard, clean, etc.) antes de que se ejecuten.

Writing Skills:

  • write-a-skill — Crea nuevos skills usando la misma estructura de la colección. Pocock incluyó el meta-skill para que puedas extender el sistema.

Cómo instalarlo

El repo incluye un directorio .claude-plugin, lo que significa que funciona directamente con el sistema de plugins de Claude Code. Clonalo y ejecutá:

claude mcp add mattpocock-skills

O copiá el directorio skills/ manualmente dentro de tu propio directorio .claude si preferís control total sobre qué incluís.

Los skills en sí son archivos de texto plano — legibles, auditables y fáciles de modificar. Sin cajas negras.


Por qué importa

Pocock es conocido por ts-reset, total-typescript y años de educación sobre TypeScript. No es un creador de herramientas de IA — es un desarrollador que usa Claude Code como parte de su workflow real y decidió compartir la configuración exacta que lo hace útil.

Esa procedencia importa. No son prompts aspiracionales escritos para una demo. Son las instrucciones que un ingeniero en actividad usa para que Claude Code no se vaya por las ramas — con TDD obligatorio, planificación estructurada antes de implementar, y guardrails sobre operaciones git destructivas.

El skill git-guardrails-claude-code merece atención especial para equipos. Las sesiones de coding agéntico acumulan estado rápido, y un reset --hard o un push directo a main de un agente que malinterpretó el contexto es exactamente el tipo de incidente que cierra el experimento para todo un equipo. Este skill se conecta al sistema nativo de hooks de Claude Code para interceptar esos comandos antes de que se ejecuten.


El tradeoff a tener en cuenta

Estos skills son opinados. El workflow TDD-first es innegociable en el setup de Pocock — si tu codebase no tiene una infraestructura de tests en la que confíes, tdd y triage-issue van a sentirse como fricción en lugar de estructura. Lo mismo con write-a-prd: archiva directamente en GitHub Issues, así que necesitás esa integración funcionando.

Los skills también asumen cierto nivel de madurez del proyecto. Están construidos para codebases con convenciones establecidas, no para prototipos desde cero.