Clase 05 · Módulo 05
Crear tu primera skill
Crear tu primera skill
Qué logras en esta clase
Conviertes un trabajo que repites en una skill propia, la cargas en tu cuenta y la dejas funcionando.
- Elegir un trabajo que merece una skill
- Armar la carpeta con sus partes
- Escribir una descripción que Claude sí reconoce
- Empaquetar, subir, probar y afinar
02
Qué trabajo merece una skill
Un buen candidato cumple tres condiciones:
- Lo haces seguido, siempre de una manera parecida
- Tiene pasos o un formato que hoy le explicas a Claude cada vez
- Sabes distinguir un resultado bueno de uno malo
Si el trabajo cambia cada vez, o todavía no sabes cómo lo quieres, una skill solo va a fijar un método a medio pensar.
03
Skill o instrucciones
| Lo que quieres fijar | Dónde va |
|---|---|
| Algo que vale en todas tus conversaciones | Instrucciones de cuenta |
| Algo que vale para un frente de trabajo | Instrucciones del proyecto |
| Un método que usas a veces, en cualquier chat | Skill |
Las dos primeras se vieron en los módulos 2 y 4. La skill tiene una ventaja: no ocupa espacio en los chats donde no hace falta.
04
La regla del alcance
Una skill, un flujo de trabajo. Si hace dos cosas, son dos skills.
05
Las partes de una skill
informe-semanal/
SKILL.md instrucciones (obligatorio)
referencias/ documentos de apoyo (opcional)
scripts/ código (opcional)Lo mínimo es una carpeta con un archivo de instrucciones. Los nombres de las subcarpetas son a tu elección; lo importante es que el archivo principal las mencione cuando las necesite.
06
El nombre del archivo principal
La especificación abierta de las skills (agentskills.io) lo llama SKILL.md, en mayúsculas, y así se usa en esta clase. El centro de ayuda de Claude lo escribe en minúsculas en algunos pasajes.
07
El encabezado
El archivo de instrucciones empieza con un bloque de datos en formato YAML, una forma simple de escribir pares «campo: valor».
| Campo | Obligatorio | Límite |
|---|---|---|
name | Sí | 64 caracteres |
description | Sí | 200 caracteres |
dependencies | No | Paquetes que necesita el código |
Debajo del encabezado va el cuerpo, escrito en Markdown.
08
Cómo se ve un encabezado
---
name: informe-semanal
description: Arma el informe semanal de ventas de la cafetería a partir de una planilla. Úsala cuando pidan el informe de la semana.
---El name de este ejemplo va en minúsculas y con guiones, sin espacios ni tildes. Es la forma más segura de evitar el error de caracteres inválidos al subirla.
09
La parte que decide todo
Claude lee la descripción para decidir si abre tu skill. Si falla ahí, el resto no se lee.
10
Descripción vaga frente a útil
| Vaga | Útil |
|---|---|
| «Ayuda con informes» | «Arma el informe semanal de ventas desde una planilla. Úsala cuando pidan el informe de la semana» |
| «Skill de correos» | «Redacta respuestas a reclamos de pacientes de la consulta. Úsala ante un reclamo recibido por correo» |
La versión útil dice dos cosas: qué hace y cuándo corresponde usarla.
11
Cómo escribir la descripción
- Empieza por la acción: arma, redacta, revisa, convierte.
- Nombra el material de entrada y el resultado.
- Agrega cuándo usarla, con las palabras que tú usarías al pedirlo.
- Cuenta los caracteres: el tope es 200.
12
Qué va en el cuerpo
Son las instrucciones que Claude sigue una vez cargada la skill. Piensa en lo que le explicarías a una persona nueva:
- El objetivo del trabajo y para quién es
- Los pasos, en orden
- El formato del resultado
- Lo que no debe hacer
- Cómo comprobar que quedó bien
Escríbelo corto y concreto. Una instrucción que se puede comprobar vale más que tres adjetivos.
13
Un ejemplo vale más que una regla
Incluye en el cuerpo al menos un ejemplo de entrada y la salida que esperas.
Con eso Claude entiende el nivel de detalle mejor que con una descripción larga del formato.
14
Archivos de apoyo y código
| Pieza | Cuándo agregarla |
|---|---|
| Documento de referencia | Hay material largo que se consulta a veces: una lista de precios, un manual de estilo |
| Script | Un paso debe salir idéntico siempre: un cálculo, una conversión |
Empieza solo con instrucciones. Agrega referencias o scripts cuando una prueba te muestre que hacen falta, no antes.
15
Tres maneras de crearla
| Vía | Para quién |
|---|---|
| Escribir los archivos a mano | Quien quiere control total |
| Redactar el texto con ayuda de Claude en un chat y revisarlo | La mayoría |
| Grabar tu pantalla mientras haces el trabajo | Planes de pago, solo en Mac |
En las dos primeras terminas con una carpeta que empaquetas y subes. La tercera se explica más adelante.
16
Empaquetar la carpeta
- Comprueba que la carpeta se llame igual que el
namedel encabezado. - Comprímela en un archivo ZIP con la opción de comprimir de tu sistema.
- Abre el ZIP y verifica que lo primero que aparece es la carpeta.
Bien: informe-semanal.zip -> informe-semanal/ -> SKILL.md
Mal: informe-semanal.zip -> SKILL.mdEl segundo caso ocurre cuando comprimes los archivos en lugar de la carpeta.
17
Subir la skill
- Abre Customize > Skills.
- Pulsa + y luego + Create skill.
- Elige Upload a skill.
- Selecciona tu archivo ZIP.
- Comprueba que aparezca en la lista con el interruptor encendido.
18
Si la subida falla
| Causa | Arreglo |
|---|---|
La carpeta no se llama como el name | Renombra una de las dos |
| Falta el archivo principal | Revisa su nombre y que esté en la raíz de la carpeta |
| Caracteres inválidos | Quita espacios, tildes y símbolos del nombre |
| ZIP demasiado grande | Saca archivos de apoyo que no se usan |
19
Subirla no es terminarla
Una skill está lista cuando se activa sola con los pedidos que harías de verdad.
20
Probarla
- Abre un chat nuevo.
- Haz un pedido que debería activarla, sin nombrarla.
- Abre el razonamiento de Claude y confirma que la cargó.
- Revisa si el resultado sigue tus pasos y tu formato.
- Repite con dos pedidos más, redactados distinto.
Prueba también un pedido que no debería activarla. Si se activa igual, la descripción es demasiado amplia.
21
El ciclo de afinado
Son dos problemas distintos con dos arreglos distintos. Cambia una sola cosa por vez y vuelve a probar: si cambias cinco, no sabrás cuál sirvió.
22
Corregirla sin salir de Claude
Los archivos de tu skill se abren junto al chat. Para cambiar una parte:
- Selecciona el texto que quieres corregir.
- Elige Edit with Claude.
- Describe el cambio.
Si la skill tiene varios archivos, junta los cambios y envíalos de una vez.
23
Grabar una skill
Claude observa tu pantalla mientras haces el trabajo y lo narras, y después propone la skill.
- Solo en Claude Desktop para Mac, dentro de las tareas
- Planes Pro, Max, Ultra y Team
- Ruta: + del cuadro de mensaje y luego Record a skill
24
Lo que nunca va dentro
Una skill es un archivo que se descarga y se puede pasar a otra persona. Trátala como un documento que algún día alguien más va a abrir.
Por eso no lleva contraseñas, claves ni datos personales de clientes o pacientes. Para los ejemplos, usa datos inventados.
25
Costos y límites
- Una skill envejece: si tu forma de trabajar cambia y ella no, entrega resultados antiguos
- Es privada; compartirla con una organización es de Team y Enterprise
- No hace mejor un método malo: lo repite más rápido
Lo bueno: sigue una especificación abierta, Agent Skills, publicada en agentskills.io. Una skill bien hecha no depende de una sola herramienta.
26
Errores que se repiten
Otros dos: meter varios trabajos en una misma skill, y agregar scripts antes de comprobar que las instrucciones solas no alcanzan.
27
Lo que te llevas
- Una skill es una carpeta con un archivo de instrucciones y un encabezado
namehasta 64 caracteres;descriptionhasta 200, con qué hace y cuándo usarla- La carpeta se llama como el
namey va como raíz del ZIP - Se sube en Customize > Skills y se prueba con pedidos reales
- Si no se activa, corrige la descripción; si sale mal, corrige el cuerpo
28
Hazlo ahora
En 15 minutos:
- Elige el trabajo marcado con S en tu lista de la clase 1.
- Escribe tres pedidos reales que harías para ese trabajo.
- Redacta el
namey unadescriptionde menos de 200 caracteres. - Escribe el cuerpo: objetivo, pasos, formato y un ejemplo.
- Empaqueta, sube y prueba con tus tres pedidos. Ajusta lo que falle.
Clase terminada
Sigue con la próxima.
Fuentes · revisadas el 18 de noviembre de 2026
- How to create custom skills (ayuda oficial de Claude)support.claude.com ↗
- Use skills in Claude (ayuda oficial de Claude)support.claude.com ↗
- What are artifacts and how do I use them? (ayuda oficial de Claude)support.claude.com ↗
- Agent Skills (especificación abierta)agentskills.io ↗
- Repositorio de skills de ejemplo de Anthropicgithub.com ↗