Cómo convertir una tarea repetitiva en una skill reutilizable para tu agente de programación con IA

Si sigues pegando la misma lista de tareas en tu agente de programación con IA — "escribe un commit convencional, luego ejecuta los tests, luego actualiza el changelog" — estás haciendo un trabajo que el agente podría recordar por ti. La mayoría de los agentes modernos te permiten empaquetar un procedimiento recurrente en un archivo pequeño y reutilizable. En Claude Code estos se llaman skills; el mismo archivo también impulsa slash commands como /deploy. Esta guía recorre cómo crear uno desde cero y luego explica los principios que se trasladan a otras herramientas.

Qué es una skill

Una skill es una carpeta con un único archivo SKILL.md dentro. Ese archivo tiene dos partes: el frontmatter YAML que le dice al agente cuándo usar la skill, y un cuerpo en markdown con las instrucciones que sigue cuando la skill se ejecuta. La ventaja clave frente a meterlo todo en un archivo CLAUDE.md (o AGENTS.md) es la divulgación progresiva: el cuerpo solo se carga cuando la skill se invoca realmente, por lo que el material de referencia extenso casi no cuesta nada hasta que lo necesitas.

Invocas una skill de dos maneras: directamente, escribiendo /nombre-de-la-skill, o de forma automática — el agente lee tu petición, la coteja con la description de la skill y la carga si es relevante.

Dónde viven las skills

Dónde colocas la carpeta decide quién puede usarla. En Claude Code, según la documentación oficial:

• ~/.claude/skills/<name>/SKILL.md — personal, disponible en todos tus proyectos.
• .claude/skills/<name>/SKILL.md — proyecto, incluida en el repositorio para que todos en el equipo obtengan el mismo comando.

El nombre de la carpeta se convierte en el comando. Una carpeta llamada summarize-changes te da /summarize-changes.

Un ejemplo concreto

Vamos a crear una skill que resuma tus cambios sin confirmar y señale cualquier cosa arriesgada antes de hacer el commit. Crea el directorio:

mkdir -p ~/.claude/skills/summarize-changes

Luego guarda esto como ~/.claude/skills/summarize-changes/SKILL.md:

---
description: Summarizes uncommitted changes and flags anything risky. Use when the user asks what changed, wants a commit message, or asks to review their diff.
---

## Current changes

!`git diff HEAD`

## Instructions

Summarize the changes above in two or three bullet points, then list any
risks you notice such as missing error handling, hardcoded values, or tests
that need updating. If the diff is empty, say there are no uncommitted changes.

Dos cosas hacen que esto funcione. Primero, la description está escrita para el agente, no para ti — nombra los disparadores ("what changed", "wants a commit message", "review their diff") para que el agente sepa cuándo recurrir a ella. Segundo, la línea !`git diff HEAD` es inyección dinámica de contexto: Claude Code ejecuta ese comando y pega su salida en el prompt antes de que el agente lea la skill. Las instrucciones llegan con tu diff real ya incrustado, por lo que la respuesta se fundamenta en tu árbol de trabajo real en lugar de en conjeturas.

Haz una pequeña edición en cualquier archivo, inicia tu agente y pruébalo de ambas formas — pregunta "¿qué cambié?" para activarla automáticamente, o escribe /summarize-changes para ejecutarla directamente.

Pasar argumentos

Las skills pueden recibir entrada. Un marcador de posición $ARGUMENTS en el cuerpo se reemplaza por lo que sea que escribas después del comando, y las variantes indexadas ($0, $1) capturan palabras específicas. Una skill invocada como /fix-issue 4821 puede referenciar el número de incidencia directamente, así que un único archivo gestiona cada incidencia en lugar de uno por ticket.

Cinco principios para skills que aguantan

Estos aplican tanto si escribes una skill de Claude Code, un comando de Cursor o — desde la función Record & Replay de OpenAI de junio de 2026 — editas una automatización que el agente grabó para ti:

1. Escribe la descripción para el modelo. Pon por delante frases disparadoras concretas. Una descripción vaga significa que el agente nunca carga la skill automáticamente, y vuelves a escribir / y a recordar nombres.
2. Mantén cada skill en una sola tarea. Una skill que despliega y ejecuta migraciones y publica en Slack es difícil de confiar y más difícil aún de depurar. Las skills pequeñas y de propósito único se combinan mejor.
3. Inyecta contexto en vivo en lugar de describirlo. Traer un diff real, el resultado de un test o un listado de archivos es mejor que decirle al agente "comprueba el estado actual" — elimina un paso en el que el agente puede equivocarse al adivinar.
4. Pon barreras a todo lo que tenga efectos secundarios. Para las skills que despliegan, migran o eliminan, exige invocación explícita en lugar de dejar que el agente las dispare automáticamente. Quieres a una persona en el bucle antes de acciones irreversibles.
5. Incluye las skills de equipo en el repositorio. Poner las skills de proyecto en .claude/skills/ y registrarlas en el repo significa que cada desarrollador — y cada ejecución del agente en CI — sigue el mismo procedimiento. Tus convenciones dejan de vivir en la cabeza de una sola persona.

Cuándo recurrir a una skill

La regla práctica: en el momento en que pegas las mismas instrucciones de varios pasos por tercera vez, o una sección de tu CLAUDE.md pasa de ser un hecho a un procedimiento, muévela a una skill. Obtienes un comando reutilizable, tu archivo de contexto se mantiene ligero y las instrucciones solo se cargan cuando realmente se necesitan — lo que mantiene tanto a ti como al agente centrados en la tarea que tienes delante.