Contenido verificado el 2026-05-07 · experimento de Eggthropic
Mi primera Agent Skill a medida
Construir una Agent Skill para Claude Code que automatiza la descripción de pull requests a partir del git diff — empaquetada como un SKILL.md reutilizable con frontmatter YAML.
Objetivo
Entender el formato de Agent Skills construyendo una skill práctica desde cero: generar descripciones estructuradas de pull request desde los cambios staged.
Contexto
Las Agent Skills son directorios con un archivo SKILL.md y frontmatter YAML que dan capacidades adicionales a los agentes. Funcionan en Claude.ai, Claude Code, el Agent SDK y la plataforma de desarrolladores. Este experimento construye una skill llamada pr-describe que lee la salida de git diff y produce una descripción de PR estandarizada siguiendo conventional commits.
Prompt utilizado
Given the output of `git diff --staged`, generate a structured pull request description with: a one-line title following conventional commits format, a Summary section (3 bullet points max), a Test Plan (numbered checklist), and a Breaking Changes section (or 'None'). Be concise and technical.
Notas de implementación
El SKILL.md usa el frontmatter YAML obligatorio (name, description) más campos opcionales de herramientas y ejemplos. El directorio .claude/skills/pr-describe/ contiene el SKILL.md, un script auxiliar get-diff.sh que prepara y canaliza el git diff, y una salida de ejemplo como referencia para Claude. Claude Code carga la skill automáticamente cuando el directorio de trabajo es un repo git y se invoca su nombre.
Resultado
La skill genera descripciones de PR que cumplen conventional commits de forma fiable. En 10 ejecuciones sobre repos distintos, el formato del título fue correcto 9/10 veces. La calidad del resumen varía con el tamaño del diff: por encima de ~500 líneas pierde precisión.
Qué funcionó
- El frontmatter YAML es mínimo y la skill cargó sin problemas
- Claude invocó el script get-diff.sh correctamente sin indicárselo
- El formato de salida fue consistente entre ejecuciones
- La skill es portable: copiar el directorio a otro proyecto simplemente funciona
Qué falló
- Los diffs muy grandes (500+ líneas) saturan la skill y degradan el resumen
- No hay lógica de truncado: el script auxiliar necesita un guard MAX_DIFF_LINES
- La skill aún no trata los merge commits de forma distinta a los de feature
Próxima iteración
Añadir troceado de diffs al script auxiliar. Publicar la skill en GitHub — el repositorio oficial anthropics/skills es la referencia canónica para skills de la comunidad.
Reprodúcelo tú
Este experimento es un playbook: con las herramientas de arriba y el prompt exacto de esta página puedes repetirlo en tu propio entorno. Si lo haces — funcione o no — cuéntanoslo en GitHub: las réplicas con resultados distintos son tan valiosas como el experimento original.