Agent Mentor Learn
Claude Code Skills: crea tus propios flujos de trabajo con IA · Lección 1 de 6

Lección 1: Qué son las Skills: por qué necesitas flujos de trabajo propios

Objetivos de aprendizaje:

  • Entender el problema de fondo que resuelven las Skills
  • Reconocer qué situaciones de trabajo vale la pena automatizar con una Skill
  • Entender el mecanismo básico con el que funcionan las Skills

Requisitos: Ya usaste las funciones básicas de Claude Code | Siguiente: Lección 2 >>

Explicas el mismo proceso una y otra vez

Estás usando Claude Code para ordenar las notas de una reunión. Escribes: «Toma esta transcripción de la reunión y conviértela en puntos estructurados: sepárala en decisiones, tareas pendientes y preguntas abiertas, y etiqueta cada tarea con un responsable y una fecha límite».

Claude lo hace. El resultado es bueno.

Al día siguiente, otra reunión. Escribes lo mismo de nuevo.

Día tres, día cuatro. Después de cada reunión vuelves a dar las mismas instrucciones. Claude acierta siempre, pero cada vez tienes que explicarlo desde cero.1

Ese es el problema que resuelven las Skills: tomar un flujo de trabajo que explicas una y otra vez y empaquetarlo como una instrucción reutilizable. Lo escribes una sola vez y lo invocas cuando lo necesites.2

Qué es una Skill

Una Skill es un directorio que contiene un archivo SKILL.md donde le dices a Claude cómo hacer una tarea concreta.3

Piénsalo como un procedimiento escrito que le entregas a Claude. Anotas los pasos con claridad y Claude trabaja a partir de ellos. Se acabó eso de empezar la explicación de nuevo.4

Por ejemplo, el núcleo de una Skill para notas de reunión podría verse así:

Una vez guardado, escribes /meeting-notes junto con el contenido de la reunión y Claude ya sabe qué hacer.1

Qué escenarios encajan con una Skill

Los escenarios que encajan con una Skill comparten tres rasgos:

  1. Repetición: haces lo mismo cada semana, cada día, a veces cada hora
  2. Pasos fijos: el proceso se puede escribir como pasos claros en vez de cambiar cada vez
  3. Verificable: puedes saber si Claude lo hizo bien

Casos típicos que encajan:

  • Revisión de código (contrastar el trabajo con las convenciones de tu equipo)
  • Conversión de formato de documentos (de Markdown a Word, conservando un formato específico)
  • Análisis de logs (extraer la señal útil de los logs de error)
  • Generación de casos de prueba (convertir la descripción de una funcionalidad en escenarios de prueba)
  • Normalización de mensajes de commit (reescribir commits escuetos en el formato acordado por tu equipo)

Escenarios que no encajan con una Skill:

  • Tareas de una sola vez (como «ayúdame a diseñar la disposición de esta página»)
  • Tareas que necesitan mucho criterio humano en cada pasada
  • Trabajo creativo totalmente abierto

Cómo funcionan las Skills

Cuando creas una Skill, en realidad estás haciendo dos cosas:5

  1. Escribir el frontmatter YAML (la parte de arriba del archivo envuelta en ---), que le dice a Claude cómo se llama esta Skill y cuándo usarla
  2. Escribir las instrucciones en Markdown (el cuerpo después del frontmatter), que le dice a Claude exactamente cómo llevar a cabo la tarea

Hay dos formas de usarla:

  • Invocación manual: escribes /meeting-notes, Claude carga las instrucciones de esa Skill y las ejecuta
  • Activación automática: dices «ordéname estas notas de reunión», Claude lee las descripciones, decide que la Skill meeting-notes es relevante y la carga por su cuenta6

La activación automática solo funciona si la description está bien escrita. Lo vemos en detalle en la lección 2.

Dónde viven las Skills

Hay dos ubicaciones:1

  • Skills personales: ~/.claude/skills/ — solo tuyas, disponibles en todos los proyectos
  • Skills de proyecto: .claude/skills/ — quedan en el directorio del proyecto, así tus compañeros las reciben al clonar el repositorio

Para tu primera Skill, empieza por las personales. Cuando hayas escrito unas cuantas y confirmes que de verdad son útiles, mueve las que más uses al directorio del proyecto para que el equipo las comparta.

Resumen

  • Las Skills empaquetan un flujo de trabajo repetitivo como una instrucción reutilizable, así no tienes que explicarlo cada vez
  • Escenarios que encajan con una Skill: repetición, pasos fijos, resultados verificables
  • Una Skill es un directorio más un archivo SKILL.md que contiene frontmatter YAML e instrucciones en Markdown
  • Dos formas de usarla: invocación manual (/skill-name) o activación automática (Claude decide a partir de la description)
  • Dos ubicaciones: Skills personales (~/.claude/skills/) y Skills de proyecto (.claude/skills/)

En la próxima lección desarmamos un archivo SKILL.md real y vemos qué hace cada una de sus partes.

Lección 2 >>

Footnotes

  1. Documentación oficial de Claude Code: Extend Claude Code with skills — https://code.claude.com/docs/en/skills ↩ ↩2 ↩3

  2. Documentación de la plataforma de Anthropic: Agent Skills overview — https://platform.claude.com/docs/en/agents-and-tools/agent-skills/overview ↩

  3. Centro de ayuda de Anthropic: How to create custom skills — https://support.claude.com/en/articles/12512198-how-to-create-custom-skills ↩

  4. Blog de ingeniería de Anthropic: Equipping agents for the real world with Agent Skills — https://www.anthropic.com/engineering/equipping-agents-for-the-real-world-with-agent-skills ↩

  5. Análisis a fondo de Claude Skills (una mirada desde los primeros principios) — https://leehanchung.github.io/blogs/2025/10/26/claude-skills-deep-dive/ ↩

  6. Building skills for Claude, en la práctica: frontmatter YAML y pruebas — https://sjramblings.io/building-skills-for-claude-part-2/ ↩

Ejercicios

01

Repasa tu última semana de trabajo y encuentra una tarea que le hayas explicado a Claude al menos tres veces.

Nivel 1: Identificar tu primera Skill candidata

Anota lo siguiente:

  1. ¿Cuál es la tarea?
  2. ¿Sus pasos son fijos?
  3. ¿Puedes saber si Claude lo hizo bien?
Criterios de finalización · marcado local