Claude Skills: crear, instalar y usar tus skills

Le repites a Claude las mismas indicaciones de una conversación a otra: tu formato de acta, tu plantilla de auditoría, tu guía de estilo. Las skills de Claude resuelven ese problema. Escribes el método una vez, en una carpeta, y Claude lo encuentra solo en cuanto la petición lo requiere.

Empiezo por la definición y la estructura de una skill, y después la instalación y la creación paso a paso, con un generador de archivos SKILL.md. Luego vienen las diferencias con los proyectos, el MCP y los subagentes, diez ejemplos, seis de ellos para SEO, y las precauciones de seguridad.

¿Qué son las skills de Claude?

Una skill («habilidad» en la interfaz en español de Claude) es una carpeta que agrupa instrucciones, scripts y recursos para una tarea concreta. El centro de ayuda de Anthropic describe estas carpetas como recursos «que Claude carga de forma dinámica»: Claude localiza las skills útiles para la petición en curso y solo lee lo que necesita.

Anthropic lanzó las skills el 16 de octubre de 2025, en la aplicación de Claude, en Claude Code y en la API. El 18 de diciembre de 2025, la empresa añadió la gestión de skills a nivel de organización, un directorio de skills creadas por partners, y publicó el formato como estándar abierto con el nombre Agent Skills, documentado en agentskills.io. Por eso te encontrarás las dos expresiones: «Claude Skills» designa la función en los productos de Claude, «Agent Skills» el formato de archivo.

En la práctica, una skill transmite un saber hacer: cómo redactas un acta, cómo auditas etiquetas, cómo escribe tu marca una cifra. Claude ya sabe redactar, analizar y programar. La skill le enseña tu manera de hacerlo.

Cómo elige y carga Claude una skill

El mecanismo se llama divulgación progresiva. Claude no lee todas tus skills enteras en cada mensaje: funciona en tres niveles, descritos en la documentación de Anthropic.

Dos consecuencias prácticas. Puedes instalar muchas skills sin saturar la conversación, ya que solo su descripción permanece cargada. Y todo depende de esa descripción: si no dice con claridad cuándo usar la skill, Claude no la abrirá.

La estructura de una skill: SKILL.md, metadatos y archivos adjuntos

Una skill es una carpeta. Solo el archivo SKILL.md es obligatorio, el resto depende de la tarea. La especificación Agent Skills recomienda esta organización:

control-etiquetas-seo/
├── SKILL.md       obligatorio: metadatos e instrucciones
├── references/    opcional: documentación que consultar
├── scripts/       opcional: código que ejecutar
└── assets/        opcional: plantillas, modelos, datos

Los metadatos: name y description

El archivo empieza con un bloque YAML delimitado por dos líneas de tres guiones. Hay dos campos obligatorios:

• name: 64 caracteres como máximo, solo minúsculas, cifras y guiones, sin guion al principio, al final ni duplicado. Debe coincidir con el nombre de la carpeta. Las palabras «claude» y «anthropic» están reservadas.
• description: lo que hace la skill y cuándo usarla, en 1.024 caracteres como máximo según la especificación. Para importarla en la aplicación de Claude, el centro de ayuda fija el límite en 200 caracteres: apunta a algo corto.

Anthropic recomienda escribir la descripción en tercera persona («Revisa las etiquetas…» mejor que «Puedo revisar…») e incluir las palabras que usas en tus peticiones. Compara:

• Descripción floja: «Ayuda para el SEO.»
• Buena descripción: «Revisa las etiquetas title y meta description de un sitio y propone correcciones. Usar para una auditoría de etiquetas, de titles o de meta descriptions.»

Las instrucciones en Markdown

Debajo de los metadatos, escribes libremente en Markdown: los pasos, el formato esperado, las reglas, un ejemplo de buen resultado. Tres principios sacados de las buenas prácticas publicadas por Anthropic:

• No expliques lo que Claude ya sabe. Conoce el SEO y el formato CSV. Escribe lo que es propio de ti: tus umbrales, tus excepciones, tu formato.
• Quédate por debajo de 500 líneas. Más allá, lleva el detalle a archivos de referencia.
• Adapta la libertad al riesgo. Una tarea delicada, como un archivo de redirecciones, requiere pasos exactos; una tarea de análisis admite indicaciones generales.

Los archivos adjuntos y los scripts

Los archivos de referencia se leen cuando hace falta: si la tarea no los necesita, no cuestan nada. Los scripts se ejecutan sin leerse, y solo su resultado entra en la conversación, lo que los hace más fiables y más económicos que un código reescrito cada vez. Dos reglas: enlaza cada archivo directamente desde SKILL.md, sin cadenas de remisiones, y escribe las rutas con barras normales, como references/umbrales.md.

Los ajustes propios de Claude Code

Claude Code acepta campos adicionales en los metadatos. Los más útiles:

• disable-model-invocation: true: la skill solo se lanza a mano, con /nombre-de-la-skill. Resérvalo para acciones delicadas, como un despliegue.
• user-invocable: false: la skill desaparece del menú y queda como una referencia que Claude consulta por sí solo.
• allowed-tools: las herramientas que Claude puede usar sin pedir permiso durante el turno en que se lanza la skill.
• context: fork: la skill se ejecuta en un subagente aislado, que no ve el historial de la conversación.

Ojo: para importarla en la aplicación o a través de la API, solo se aceptan name, description, license, compatibility, metadata y allowed-tools. Cualquier otro campo hace fallar la importación.

Dónde funcionan las Claude Skills: aplicación, Claude Code y API

El mismo formato de carpeta sirve en todas partes, pero cada superficie tiene sus reglas.

Tres puntos clave. La ejecución de código tiene que estar activada; si no, las skills no funcionan. Según el centro de ayuda de Anthropic, las skills funcionan en todos los planes, desde el gratuito hasta Enterprise. Y no se sincronizan: una skill importada en la aplicación no existe ni en la API ni en Claude Code, hay que instalarla en cada superficie.

Las skills también funcionan en Claude Cowork, el modo agente de Claude para el trabajo de oficina, donde suelen llegar dentro de plugins, junto a conectores y subagentes.

Cómo instalar una skill de Claude

En la aplicación de Claude

1. Abre Configuración > Capacidades y comprueba que la ejecución de código y la creación de archivos están activadas.
2. Ve a Personalizar > Habilidades.
3. Haz clic en + y elige crear una habilidad a partir de un archivo (Create skill y luego Upload a skill en la interfaz en inglés).
4. Elige el archivo ZIP. La carpeta de la skill debe estar en la raíz del ZIP: mi-skill.zip contiene mi-skill/SKILL.md, no un archivo SKILL.md suelto.
5. Activa la skill y pruébala en una conversación nueva.

En los planes Team o Enterprise, el administrador debe autorizar antes la ejecución de código y las habilidades en Configuración de la organización > Complementos y habilidades. En Cowork, el directorio de skills, que se abre desde Personalizar y luego el botón +, también ofrece skills listas para instalar, entre ellas las de partners como Notion, Figma, Canva o Atlassian.

En Claude Code

Claude Code lee las skills directamente desde carpetas, sin importación. Si todavía no tienes la herramienta en tu máquina, empieza por instalar Claude Code.

1. Copia la carpeta de la skill en ~/.claude/skills/ para tenerla en todos tus proyectos, o en .claude/skills/ en la raíz de un proyecto para compartirla con tu equipo a través de Git.
2. Escribe /skills para comprobar que aparece.
3. Deja que Claude la use solo cuando la petición encaje, o lánzala con /nombre-de-la-skill.

Para instalar las skills publicadas por Anthropic, añade su repositorio como marketplace de plugins y después instala el paquete que te interese:

/plugin marketplace add anthropics/skills
/plugin install document-skills@anthropic-agent-skills
/plugin install example-skills@anthropic-agent-skills

Los antiguos comandos personalizados, guardados en .claude/commands/, siguen funcionando: Claude Code los trata ahora como skills.

A través de la API de Claude

Para los desarrolladores, las skills pasan por la herramienta de ejecución de código. Declaras la skill en el parámetro container de la petición, con su identificador: pptx, xlsx, docx o pdf para las de Anthropic, o el de una skill que hayas subido a través de los endpoints /v1/skills. La skill se ejecuta entonces en un contenedor sin acceso a internet, compartido con todo el espacio de trabajo.

Dónde encontrar skills para Claude

• El repositorio oficial anthropics/skills en GitHub: skills de documentos, de creación, de desarrollo y de comunicación. Anthropic precisa que se ofrecen como demostración y que hay que probarlas antes de fiarse de ellas.
• El directorio integrado en Claude, con las skills de Anthropic y las de partners.
• Los catálogos de la comunidad: hay varios, que recopilan miles de skills de calidad muy desigual. Lee cada archivo antes de instalarlo; la parte de seguridad, más abajo, explica qué revisar.
• Tus propias skills, a menudo las más útiles, porque contienen lo que ningún catálogo conoce: tu método.

Crear una skill de Claude paso a paso

Una skill sencilla cabe en un archivo de texto. El método que sigue vale para todas las superficies; solo cambia el último paso.

1. Elige una tarea que explicas a menudo. La buena candidata es la indicación que copias de una conversación a otra: un formato de informe, una plantilla de control, una guía de estilo.
2. Haz la tarea una vez con Claude, sin skill. Apunta lo que tienes que precisar o corregir: es exactamente la información que le falta a Claude, y por tanto el contenido de la skill.
3. Crea la carpeta y el archivo. Una carpeta con el nombre de la skill, en minúsculas con guiones, y dentro un archivo SKILL.md.
4. Escribe los metadatos. El nombre y luego una descripción que diga qué hace la skill y cuándo usarla, con las palabras de tus peticiones.
5. Escribe las instrucciones. Los pasos en orden, el formato del resultado, las reglas que hay que respetar y, si es posible, un ejemplo de resultado bien hecho.
6. Añade los archivos útiles. Un baremo en references/, una plantilla en assets/, un script de comprobación en scripts/. Nada es obligatorio.
7. Pruébala con tres peticiones reales. En una conversación nueva, formula la petición como siempre, sin mencionar la skill. El razonamiento que muestra Claude debe indicar que lee la skill. Si la ignora, vuelve a trabajar la descripción.
8. Instálala según la superficie: ZIP en la aplicación, carpeta en Claude Code, envío por la API.

Sin escribir una línea: pedirle a Claude que cree la skill

Claude conoce el formato. Después de hacer una tarea con él, pídele: «Crea una skill que recoja el método que acabamos de aplicar, con las reglas que te he dado.» Anthropic publica además una skill específica, skill-creator, que guía la creación, la modificación y la prueba de una skill. Revisa siempre el resultado: un modelo tiende a añadir explicaciones innecesarias que hay que recortar.

En Claude Cowork para Mac, los planes Pro, Max y Team también permiten grabar una skill: realizas la tarea en pantalla, durante unos diez minutos como mucho, y Claude propone una skill a partir de la grabación. La función no existe ni en el chat, ni en Windows, ni en los planes gratuito y Enterprise.

Ejemplo completo de archivo SKILL.md

Aquí tienes una skill de SEO completa, lista para adaptar. Recoge la cadena de control de etiquetas que ejecuto en mis proyectos con clientes con Claude Code.

---
name: control-etiquetas-seo
description: "Revisa las etiquetas title y meta description de un sitio y propone correcciones. Usar para una auditoría de etiquetas, de titles o de meta descriptions."
---

# Control de etiquetas SEO

## Pasos
1. Leer la exportación del rastreo facilitada (CSV) o rastrear las URL indicadas.
2. Localizar los titles ausentes, duplicados, de menos de 30 o de más de 60 caracteres.
3. Hacer lo mismo con las meta descriptions (ausentes, duplicadas, más de 155 caracteres).
4. Proponer una reescritura para cada página con errores, con el número de caracteres.
5. No modificar ningún archivo sin validación explícita.

## Formato del resultado
Una tabla: URL, problema, etiqueta actual, propuesta, número de caracteres.
Después, las cinco páginas que hay que tratar primero, ordenadas por tráfico si la exportación lo incluye.

## Reglas
- El title contiene la búsqueda a la que apunta la página, al principio si es posible.
- Ninguna promesa imposible de verificar («el mejor», «n.º 1»).
- Señalar los casos dudosos en una lista para decidir en lugar de zanjarlos.

## Referencia
Umbrales y excepciones propios del sitio: ver references/umbrales.md

Para escribir la tuya, el generador de abajo monta el archivo a partir de tus respuestas, comprueba el nombre y la longitud de la descripción, y te indica dónde colocarlo según la superficie elegida.

Skills, proyectos, MCP, subagentes: ¿qué diferencias hay?

Claude ofrece varias formas de darle contexto, y es fácil confundirlas. Anthropic resume la distinción así: un proyecto le dice a Claude lo que debe saber, una skill le dice cómo hacerlo y el MCP lo conecta con tus datos.

Skill o proyecto. Un proyecto almacena material (documentos, indicaciones generales) disponible en todas sus conversaciones. Una skill almacena un procedimiento, que solo se carga cuando sirve, en cualquier conversación, sea cual sea el proyecto.

Skill o MCP. El MCP le da herramientas a Claude: leer Search Console, lanzar un rastreo. La skill le dice qué hacer con ellas: qué páginas comparar, qué umbrales aplicar, qué tabla entregar. Las dos se combinan, y a menudo es la mejor configuración. Explico cómo funciona un servidor MCP en un artículo específico.

Skill o subagente. Un subagente es un asistente completo, con su propio contexto, en el que el agente principal delega una parte del trabajo. Una skill es un saber hacer que cualquier instancia de Claude puede cargar. En Claude Code, los dos se juntan con context: fork, que ejecuta una skill dentro de un subagente. Para la lógica de agente en general, mira cómo crear un agente de IA.

10 ejemplos de skills de Claude, 6 de ellos para SEO

Las cuatro primeras las proporcionan Anthropic o sus partners, o se escriben en pocas líneas. Las seis siguientes recogen las tareas SEO que automatizo con Claude Code en mis proyectos: cada una tiene un dato de entrada propio, una regla explícita y un resultado verificable, lo que las convierte en buenas candidatas.

Las skills listas para usar y las skills de oficio

1. Las skills de documentos de Anthropic

Word, Excel, PowerPoint y PDF: Claude las usa por iniciativa propia cuando pides un documento, tanto en la aplicación como en la API. Son las que le permiten producir una hoja de cálculo con fórmulas o una presentación maquetada.

2. skill-creator, la skill que crea skills

Hace las preguntas útiles, redacta el SKILL.md, ayuda a modificarlo y a medir si se activa como estaba previsto. Está en el repositorio oficial de Anthropic.

3. Las skills de partners

Notion, Figma, Canva o Atlassian publican skills que enseñan a Claude a trabajar con sus herramientas. Se instalan desde el directorio de skills de Claude, como las de Anthropic.

4. Una skill de guía de estilo editorial

Tu tono, tus palabras prohibidas, la forma de escribir las cifras, dos textos de referencia en references/. Es una buena primera skill para un equipo, porque la guía de estilo se aplica a todo lo que se escribe.

---
name: guia-de-estilo
description: "Aplica la guía de estilo editorial de la empresa a cualquier texto redactado o revisado. Usar para un correo, un post, una página web o una revisión."
---

6 skills de SEO que crear

Para estas skills, Claude necesita acceder a los datos: los archivos del sitio, un crawler, Search Console. Esos accesos pasan por conectores MCP, como el MCP de Screaming Frog para los rastreos. La skill, por su parte, aporta el método. Otros usos de Claude en posicionamiento web se detallan en Claude para SEO.

5. Control de las etiquetas title y meta

El punto de partida evidente: la tarea es mecánica, se comprueba de un vistazo y resulta imposible de mantener al día a mano en varios cientos de páginas. El ejemplo completo está más arriba. La salvaguarda: Claude propone, tú revisas, porque una etiqueta es lo que ve el usuario en los resultados de búsqueda.

6. Auditoría del enlazado interno

Extraer la estructura de enlaces, localizar las páginas huérfanas y demasiado profundas, proponer tres enlaces entrantes por página prioritaria con su texto ancla. La regla que impongo en mis indicaciones: ningún anchor text genérico, todo anchor debe describir la página de destino.

---
name: auditoria-enlazado-interno
description: "Analiza el enlazado interno a partir de un rastreo, localiza las páginas huérfanas o demasiado profundas y propone enlaces con su anchor text. Usar para una auditoría de enlaces internos."
---

7. Datos estructurados JSON-LD

Generar el marcado de un catálogo o de un conjunto de artículos y después validar la sintaxis. Regla absoluta: el marcado refleja lo que se ve en la página, sin completar un dato que falta con un valor verosímil.

---
name: datos-estructurados
description: "Genera el marcado JSON-LD de una página a partir de su contenido visible, sin inventar datos ausentes. Usar para añadir o corregir datos estructurados."
---

8. Plan de redirecciones de una migración

Emparejar cada URL antigua con su equivalente, señalar las direcciones sin correspondencia evidente en lugar de zanjarlas, generar el archivo evitando cadenas y bucles. A esta skill le conviene seguir siendo manual: en Claude Code, añade la línea de abajo.

---
name: plan-redirecciones
description: "Elabora el plan de redirecciones 301 de una migración, de una URL antigua a un destino concreto. Usar en un rediseño o un cambio de URL."
disable-model-invocation: true
---

9. Informe mensual de Search Console

Comparar dos periodos, aislar las caídas, cruzarlas con los cambios hechos entretanto y terminar con tres acciones. Precaución de método que hay que incluir en la skill: comparar periodos de al menos 28 días, una variación en una semana no significa nada.

---
name: informe-search-console
description: "Compara dos periodos de datos de Search Console, aísla las páginas y búsquedas en descenso y propone tres acciones. Usar para un informe mensual de seguimiento SEO."
---

10. Control antes de publicar

Longitud de las etiquetas, jerarquía de los encabezados, enlaces internos válidos, atributos alt, afirmaciones sin fuente. Una revisión técnica sistemática, que no sustituye a la revisión editorial: un texto puede pasar todos los controles y seguir siendo malo.

---
name: control-antes-de-publicar
description: "Comprueba una página antes de publicarla: etiquetas, encabezados, enlaces internos, atributos alt y afirmaciones sin fuente. Usar antes de publicar un artículo o una página."
---

Límites y seguridad de las Claude Skills

Una skill no es un simple texto: puede contener scripts y orientar las herramientas que usa Claude. Anthropic recomienda tratarla como la instalación de un programa.

• Instala solo skills de confianza, las tuyas o las de Anthropic. Una skill maliciosa puede llevar a Claude a ejecutar código o a enviar datos al exterior.
• Léelo todo antes de instalar una skill encontrada en internet: SKILL.md, scripts, recursos. Desconfía de las llamadas de red inesperadas y de las skills que van a buscar indicaciones a una URL externa, cuyo contenido puede cambiar después de tu revisión.
• Sin sincronización entre la aplicación, Claude Code y la API: cada superficie tiene su copia, que hay que mantener al día.
• La activación depende de la descripción. Si es demasiado vaga, Claude ignora la skill; si es demasiado amplia, la carga cuando no toca. Dos skills con descripciones parecidas se estorban.
• Cada skill ocupa algo de contexto de forma permanente, unos 100 tokens de metadatos: cincuenta skills ya suponen unos 5.000 tokens.
• En la API, no hay acceso a internet ni instalación de paquetes, y las skills no están cubiertas por los acuerdos de retención cero de datos.
• En la empresa, las organizaciones Enterprise pueden activar un análisis del contenido de las skills importadas en Claude y en Cowork.

Si quieres skills de tu oficio diseñadas, probadas con tus propios archivos y entregadas con estas salvaguardas, es lo que hago en mis proyectos de automatización con IA.

Escrito por

Anthony Courtin

Consultor SEO, GEO y automatización con IA

Acompaño a pymes y profesionales independientes en su visibilidad (Google, ChatGPT, Perplexity) y en el uso real de la IA en el trabajo. Intervengo en empresas para formar a los equipos y replantear los procesos. Todo lo que escribo aquí, lo uso en mis proyectos con clientes.

Sígueme en LinkedIn Mi canal de YouTube (en francés)