📦 Módulo 2.1 — Qué es mp-skill

O mp-skill es la versión en portugués del repositorio mattpocock/skills, creado por Matt Pocock — el mismo tipo detrás de Total de TypeScript, de los artículos sobre TypeScript que probablemente ya te sacaron de algún apuro, y del boletín AI Hero sobre IA aplicada a la ingeniería.

Matt empezó a crear estas skills después de enfrentarse a los failure modes recurrentes de Claude Code y Codex: el agente olvida el contexto entre sesiones, inventa APIs que no existen, omite pruebas, hace refactors enormes sin necesidad o simplemente "alucina" un plan y empieza a escribir código que no funciona.

En vez de aceptar esto como una "limitación del modelo", Matt decidió codificar las soluciones. Cada vez que descubría un patrón que evitaba un modo de falla, se convertía en una skill. Cada vez que tenía que repetir una instrucción manualmente en tres sesiones seguidas, se convertía en una skill. El resultado es un repositorio que parece pequeño, pero resuelve decenas de problemas reales.

Matt documenta la evolución del proyecto en su newsletter. Vale la pena leerla, especialmente las publicaciones en las que explica por qué nació una skill (qué error del agente intenta corregir).

🔗 Newsletter: aihero.dev/s/skills-newsletter

Tres adjetivos definen el proyecto: small (pequeñas), composable (componibles) y adaptable (adaptables). Cada skill hace una cosa, la hace bien y puede combinarse con otras sin complicaciones.

Esta filosofía es una respuesta directa a los frameworks "todo en uno" que aparecieron en el ecosistema —GSD, BMAD-METHOD, Spec-Kit—. Funcionan, pero tienen un costo: adoptas todo su proceso o nada.

El repositorio agrupa las skills en buckets (carpetas) según la madurez y la finalidad. Esto no es solo un detalle organizativo: define qué skills aparecen públicamente y cuáles quedan internas.

skills/
├── engineering/      # daily code work — TDD, code review, debugging
├── productivity/     # daily non-code workflow — handoff, grill-me
├── misc/             # kept around but rarely used
├── personal/         # tied to author's setup, not promoted
├── in-progress/      # drafts not yet ready to ship
└── deprecated/       # archived, kept for reference

Las las tres primeras (engineering, productivity, misc) son públicas: aparecen en el README del proyecto y en la lista .claude-plugin/plugin.json. Las las tres últimas (personal, en progreso, obsoletas) quedan internas: existen en el repo, pero no se exponen oficialmente como skills del plugin.

Esta estructura mantiene el repositorio honesto: lo que está promovido se probó y Matt lo usa de verdad; lo que está en drafts está claramente identificado; lo que se descontinuó queda documentado, pero no estorba a quien está empezando.

GSD (Get-Stuff-Done), BMAD-METHOD y Spec-Kit son frameworks populares para el "agentic coding". Funcionan, pero resuelven un problema diferente al que resuelven las skills. Vale la pena entender la diferencia antes de elegir.

No es «uno es mejor que el otro», sino problema diferente. Si necesitas un proceso completo desde cero, usa un framework. Si ya tienes un proceso y quieres reforzar los puntos débiles del agente, usa skills.

Las skills no son exclusivas de un perfil. Lo que cambia es cuáles las skills se incorporan y en qué orden. Tres perfiles comunes:

¿Y cuál es la curva de adopción típica? Casi siempre sigue el mismo orden: instala el repo, prueba una skill, observa el beneficio y agrega la siguiente. En dos semanas, se convierte en un workflow.

⏱️ Cronología típica de adopción

El proyecto es MIT. Traducción pragmática: puedes usar, copiar, modificar, distribuir y vender, en un proyecto personal, en una empresa o en un producto comercial. Lo único que se exige es mantener el aviso de copyright y la licencia en el código.

El modelo de contribución es fork-friendly. Matt acepta PRs, pero espera que cada PR sea enfocado: una skill nueva, una corrección en una skill existente, una mejora de docs. Los PR gigantes ("reescribí todo") tienden a rechazarse —no por hostilidad, sino por filosofía: el proyecto es pequeño a propósito.

# 1. Fork no GitHub, depois:
git clone https://github.com/SEU_USER/skills.git
cd skills
git checkout -b minha-skill

# 2. Criar a skill em engineering/ ou productivity/
mkdir -p skills/engineering/minha-skill
$EDITOR skills/engineering/minha-skill/SKILL.md

# 3. Registrar nos dois lugares públicos obrigatórios:
$EDITOR README.md                        # adicionar linha com link
$EDITOR .claude-plugin/plugin.json       # adicionar entrada
$EDITOR skills/engineering/README.md     # descrição de 1 linha no bucket

# 4. Commit + push + PR
git add .
git commit -m "feat: add /minha-skill"
git push origin minha-skill
gh pr create --base main

Este repositorio (mp-skill, mantenido por inematds) es un fork activo del mattpocock/skills con dos objetivos adicionales:

En resumen: mp-skill = mattpocock/skills + PT-BR + curso. La misma filosofía, el mismo conjunto base de skills, la misma estructura de buckets: solo se elimina la barrera del idioma y se agrega material didáctico.