Tu primera skill, paso a paso

Tu primera skill, paso a paso

Ya tienes las cinco partes pensadas en papel. El problema que queda es el más práctico de todos: convertir esas notas en un archivo SKILL.md real, guardado en el lugar correcto, activado y probado. Esta lección te lleva por ese camino completo, de principio a fin, sin que necesites saber programar.

Paso 1: redacta el SKILL.md con ayuda de Claude

No tienes que escribir el archivo desde cero tú solo. Puedes pedirle a Claude que te ayude a redactarlo, usando tus notas de la lección anterior como punto de partida. Este prompt te sirve como plantilla:

Quiero crear una skill para mi negocio. Ayúdame a escribir el
archivo SKILL.md completo, con el formato real: frontmatter entre
dos líneas de tres guiones con los campos "name" (en minúsculas
y guiones) y "description" (que diga qué hace y cuándo usarla,
empezando por "Úsala cuando..."), y después las instrucciones en
Markdown.

Datos de mi skill:
- Nombre de la tarea: [nombre de tu tarea]
- Qué hace: [describe la tarea en una o dos frases]
- Cuándo se usa: [la situación exacta que la dispara]
- Datos que necesita para empezar: [lista]
- Pasos que debe seguir: [lista]
- Reglas que no se pueden romper: [lista]
- Un ejemplo de entrada y salida: [tu ejemplo]

Devuélveme el archivo SKILL.md completo, listo para guardar.

Revisa lo que Claude te devuelva contra las cinco partes de la lección anterior: nombre, descripción, instrucciones, ejemplos y archivos de apoyo si hacen falta. Ajusta lo que no coincida exactamente con cómo trabaja tu negocio.

Paso 2: guarda la carpeta en el lugar correcto

Crea una carpeta con el nombre exacto de tu skill (el mismo que pusiste en el campo name) y guarda ahí el archivo SKILL.md, más cualquier archivo de apoyo que necesites. Desde ahí, el camino depende de dónde vayas a usar la skill:

• Si vas a subirla en Claude (la app web, de escritorio o móvil): comprime esa carpeta en un archivo .zip y súbela desde los ajustes, en la sección de capacidades, según lo que incluya tu plan.
• Si usas Claude Code (la herramienta que trabaja con carpetas y archivos de tu computadora desde la terminal): coloca la carpeta directamente dentro de la carpeta de skills del proyecto en el que trabajas, o en la carpeta general de skills de tu usuario, sin necesidad de comprimirla.

La interfaz exacta para subir o activar una skill puede cambiar y verse distinta a lo que describimos aquí: guíate por la sección de capacidades o de skills en los ajustes, y confírmalo en la ayuda oficial de Claude si tienes dudas.

Paso 3: actívala y pruébala con tres casos

Una vez subida, activa la skill si el sistema te lo pide de forma explícita (en algunos casos queda activa apenas se sube; en otros hay que habilitarla). Después, pruébala con al menos tres casos distintos, no solo uno:

1. Un caso típico, del centro de lo que la skill debería resolver.
2. Un caso con un dato incompleto, para ver si la skill pide lo que falta en vez de inventarlo.
3. Un caso al límite, distinto a lo que probablemente imaginaste, para ver si la skill sigue respondiendo bien o si se sale del formato.

Cómo saber si se activó: revisa si la respuesta sigue el formato y las reglas exactas que escribiste en el SKILL.md. Si la respuesta se ve genérica, sin ese formato, lo más probable es que la skill no se haya activado, y el problema casi siempre está en la descripción (repasa la lección 3.4 sobre la fórmula "Úsala cuando...").

Cómo corregirla: si algo no salió como esperabas, edita el archivo SKILL.md (ajusta la descripción, un paso, o agrega el caso que falló como ejemplo nuevo) y vuelve a probar los tres casos otra vez, no solo el que falló.

Paso 4: versiona tus cambios

Antes de editar una skill que ya está funcionando, guarda una copia de la versión anterior (puede ser tan simple como duplicar el archivo con la fecha en el nombre, por ejemplo SKILL-2025-01-antes.md). Así, si el cambio nuevo funciona peor que el anterior, puedes volver atrás sin tener que reconstruir la skill desde cero. Este hábito se vuelve más importante mientras más dependas de esa skill en tu trabajo diario.

Ejemplo

Un taller mecánico en Tijuana quiere convertir las notas rápidas que el mecánico anota en el taller ("cambio de balatas delanteras, rectificar discos, 2 h") en un presupuesto ordenado para el cliente, con partes, mano de obra y garantía. El dueño usa el prompt del paso 1 para armar el archivo con ayuda de Claude, y después de un ajuste en la descripción, llega a esta versión final:

---
name: presupuesto-reparacion
description: Convierte notas cortas de un mecánico sobre el trabajo
  a realizar en un presupuesto ordenado para el cliente, con partes,
  mano de obra y garantía. Úsala cuando el mecánico anote el
  diagnóstico y el trabajo a hacer y haya que entregarle un
  presupuesto por escrito al cliente.
---

# Presupuesto de reparación

## Qué necesita esta skill para empezar
- Las notas del mecánico sobre el diagnóstico y el trabajo
- El tiempo estimado de mano de obra
- Los precios de partes y mano de obra por hora (campos que
  llena el dueño, sin valores fijos en esta skill)

## Pasos
1. Lee las notas del mecánico y separa el trabajo en partes
   (piezas a cambiar) y mano de obra (horas de trabajo).
2. Arma una tabla con tres columnas: concepto, cantidad u horas,
   y precio (deja el precio como campo [PRECIO] para que el
   dueño lo complete).
3. Agrega una línea con el tiempo de garantía estándar del
   taller (campo [GARANTIA] para que el dueño lo complete).
4. Cierra el presupuesto con una frase que aclare que el precio
   final puede variar si al revisar el vehículo aparece un
   trabajo adicional.
5. Deja el presupuesto como borrador para que el dueño revise
   los precios antes de entregarlo al cliente.

## Reglas que no se rompen
- Nunca inventes un precio: siempre deja el campo [PRECIO]
  para que lo complete una persona.
- Nunca prometas una fecha de entrega sin confirmar con el
  taller.

## Ejemplo de entrada y salida
Entrada: "cambio de balatas delanteras, rectificar discos, 2 h"

Salida esperada: una tabla con dos filas de partes (balatas
delanteras, rectificado de discos) y una fila de mano de obra
de 2 horas, cada una con el campo [PRECIO], más la línea de
garantía y el cierre aclarando que el precio final se confirma
al revisar el vehículo.

El dueño la prueba con tres notas reales del mecánico: una típica (como la del ejemplo), una donde falta el tiempo estimado (y confirma que la skill pregunta por ese dato en vez de inventarlo), y una con un trabajo poco común que nunca habían presupuestado antes. En ese tercer caso, la tabla sale bien, pero la skill no incluye una nota que el dueño siempre agrega a mano en trabajos poco comunes: que el presupuesto puede cambiar tras una revisión más profunda. Ajusta las instrucciones para agregar esa nota siempre que el trabajo no sea uno de los más frecuentes, y vuelve a probar los tres casos.

Errores comunes

• Probar la skill una sola vez y darla por terminada. Un solo caso no muestra si la skill maneja los datos incompletos o los casos poco comunes.
• Subir la skill sin revisar el formato del frontmatter. Si las líneas de guiones o los campos name/description no están exactamente como corresponde, la skill puede no cargarse bien.
• Dejar que la skill invente precios o datos que debería completar una persona. Usa campos entre corchetes para lo que el dueño del negocio debe llenar a mano.
• No guardar la versión anterior antes de editar. Sin ese respaldo, un cambio que empeora la skill es difícil de revertir.
• Olvidar dónde la guardaste. Si la subiste como .zip en Claude o la pusiste en una carpeta de Claude Code, anota el lugar exacto para poder editarla después sin tener que buscarla de nuevo.

Tu tarea

1. Usa el prompt del paso 1 para pedirle a Claude que te ayude a redactar el archivo SKILL.md completo de tu skill, con las notas que escribiste en la lección 3.4.
2. Guarda el archivo en una carpeta con el nombre exacto de la skill.
3. Súbela como .zip en Claude o colócala en tu carpeta de skills de Claude Code, según cómo trabajes.
4. Pruébala con tres casos: uno típico, uno con un dato incompleto, y uno al límite.
5. Corrige la descripción o las instrucciones al menos una vez, según lo que encuentres en las pruebas, y guarda la versión anterior antes de editar.