Saltar al contenido
estudIA

MCP3 min de lectura

Skills de Claude: qué son y cómo crear la tuya

Qué son las Agent Skills de Claude, en qué se diferencian de un prompt o un conector MCP y cómo crear una skill propia para Claude Code o claude.ai.

En resumen

  1. Elige una tarea repetible. Algo que haces a menudo y siempre de la misma forma.
  2. Crea la carpeta y el SKILL.md. Con name y description en el frontmatter y las instrucciones en el cuerpo.
  3. Escribe una buena descripción. Qué hace la skill y cuándo debe usarse: es lo que Claude lee para decidir.
  4. Añade recursos si hacen falta. Plantillas, ejemplos o scripts en la misma carpeta.
  5. Instálala y pruébala. En .claude/skills/ para Claude Code o subida como zip en los ajustes de claude.ai.

Las skills son la forma de enseñar a Claude a hacer una tarea siempre de la misma manera, sin repetirle las instrucciones. Una skill es una carpeta con un archivo SKILL.md (instrucciones) y, si hace falta, plantillas, ejemplos o scripts. Claude ve una descripción breve de cada skill disponible y solo carga las instrucciones completas cuando la tarea las necesita.

Skill, prompt o conector: qué usar

Para qué Dura
Prompt Una petición concreta Una conversación
Proyecto Contexto y archivos de un tema Las conversaciones del proyecto
Skill Cómo hacer un tipo de tarea, con recursos y scripts Siempre, en cualquier conversación donde encaje
Conector MCP Acceso a una aplicación o a unos datos Mientras esté conectado

Ejemplos de buenas skills: «redacta las actas de reunión con nuestra plantilla», «revisa un contrato con nuestra lista de control», «crea las diapositivas con la marca de la empresa». Anthropic incluye skills ya hechas para trabajar con documentos de Word, Excel, PowerPoint y PDF.

Cómo funcionan por dentro

Las skills usan lo que Anthropic llama revelación progresiva, una aplicación de la ingeniería de contexto:

  1. Siempre cargado: solo el nombre y la descripción de cada skill (unos 100 tokens por skill).
  2. Al activarse: el cuerpo del SKILL.md con las instrucciones.
  3. Solo si hace falta: los archivos de apoyo y los scripts. De los scripts, solo entra en el contexto su resultado, no su código.

Por eso puedes tener muchas skills instaladas sin llenar la ventana de contexto.

Paso 1: elige una tarea repetible

La mejor candidata es algo que haces a menudo, que tiene una forma correcta de hacerse y que te cansa explicar. Si cada vez es distinto, mejor un prompt.

Paso 2: crea la carpeta y el SKILL.md

Una skill para redactar actas, por ejemplo, en actas-de-reunion/SKILL.md:

---
name: actas-de-reunion
description: Redacta actas de reunión con la plantilla del equipo a partir de notas o transcripciones. Úsala cuando el usuario pida un acta, un resumen de reunión o las tareas acordadas en una reunión.
---

# Actas de reunión

## Instrucciones
1. Identifica asistentes, fecha y tema a partir del material.
2. Resume las decisiones en frases cortas, una por línea.
3. Lista las tareas con responsable y fecha; si falta alguno, escribe «sin asignar».
4. Usa exactamente la estructura de plantilla.md.
5. No inventes nada que no esté en el material.

## Ejemplo
Mira ejemplo.md para ver un acta bien hecha.

Las reglas del frontmatter, según la documentación oficial:

  • name: máximo 64 caracteres, solo minúsculas, números y guiones, y sin las palabras reservadas «anthropic» ni «claude».
  • description: obligatoria, máximo 1.024 caracteres. Debe decir qué hace y cuándo usarla.

Paso 3: la descripción lo es todo

Claude decide si usa la skill comparando tu petición con la descripción. Una descripción vaga («ayuda con documentos») hará que no se active o que se active cuando no toca. Incluye las palabras que usarías al pedirlo («acta», «resumen de reunión», «tareas acordadas»).

Paso 4: añade recursos

En la misma carpeta puedes poner:

  • plantilla.md con la estructura exacta.
  • ejemplo.md con un caso bien resuelto.
  • scripts/ con programas para lo que deba ser exacto (por ejemplo, dar formato a fechas o validar datos).

Menciónalos en el SKILL.md para que Claude sepa cuándo leerlos.

Paso 5: instálala

  • Claude Code: copia la carpeta en ~/.claude/skills/ (para ti, en todos tus proyectos) o en .claude/skills/ dentro de un proyecto (para todo el equipo que use ese repositorio). Claude la usará cuando encaje, y también puedes invocarla escribiendo / seguido de su nombre.
  • claude.ai: comprime la carpeta en un zip y súbela en Configuración → Funciones. Disponible en los planes Pro, Max, Team y Enterprise con la ejecución de código activada.
  • API: se suben por la API de skills y se comparten en todo el espacio de trabajo.

Las skills no se sincronizan entre estos sitios: hay que instalarlas en cada uno.

Seguridad

Una skill puede incluir instrucciones y código que Claude ejecutará, así que Anthropic recomienda usar solo skills de fuentes de confianza (las tuyas o las oficiales) y revisar a fondo cualquier otra antes de instalarla, como harías con un programa. Tienes más consejos en seguridad de agentes.

Para inspirarte, mira el repositorio oficial de skills de Anthropic. Y si lo que necesitas es dar acceso a una aplicación, no enseñar una tarea, lo tuyo es un conector MCP.

Preguntas frecuentes

¿Qué diferencia hay entre una skill y un conector MCP?

Una skill enseña a Claude cómo hacer algo (instrucciones, plantillas, scripts). Un conector MCP le da acceso a con qué hacerlo (una aplicación o unos datos). Se complementan.

¿Se sincronizan entre Claude Code y claude.ai?

No. Las skills de Claude Code viven en tu disco, las de claude.ai se suben en sus ajustes y las de la API se suben por la API. Hay que instalarlas en cada sitio.

Términos del glosario

Fuentes

Artículos relacionados