Las Skills personalizadas te permiten mejorar Claude con conocimientos especializados y flujos de trabajo específicos de tu organización o estilo de trabajo personal. Este artículo explica cómo crear, estructurar y probar tus propias Skills.

Las Skills pueden ser tan simples como unas pocas líneas de instrucciones o tan complejas como paquetes de múltiples archivos con código ejecutable. Las mejores Skills:

Resuelven una tarea específica y repetible
Tienen instrucciones claras que Claude puede seguir
Incluyen ejemplos cuando es útil
Definen cuándo deben usarse
Se enfocan en un flujo de trabajo en lugar de intentar hacer todo

Crear un archivo Skill.md

Cada Skill consiste en un directorio que contiene como mínimo un archivo Skill.md, que es el núcleo de la Skill. Este archivo debe comenzar con un frontmatter YAML para contener los campos de nombre y descripción, que son metadatos requeridos. También puede contener metadatos adicionales, instrucciones para Claude o archivos de referencia, scripts ejecutables o herramientas.

Campos de metadatos requeridos

name: Un nombre descriptivo para tu Skill (máximo 64 caracteres)

Ejemplo: Directrices de Marca

description: Una descripción clara de lo que hace la Skill y cuándo usarla.

Esto es crítico—Claude usa esto para determinar cuándo invocar tu Skill (máximo 200 caracteres).
Ejemplo: Aplicar las directrices de marca de Acme Corp a presentaciones y documentos, incluyendo colores oficiales, fuentes y uso del logotipo.

Campos de metadatos opcionales

version: Rastrea las versiones de tu Skill a medida que iteras.

Ejemplo: 1.0.0

dependencies: Paquetes de software requeridos por tu Skill.

Ejemplo: python>=3.8, pandas>=1.5.0

Los metadatos en el archivo Skill.md sirven como el primer nivel de un sistema de divulgación progresiva, proporcionando suficiente información para que Claude sepa cuándo debe usarse la Skill sin tener que cargar todo el contenido.

Cuerpo en Markdown

El cuerpo en Markdown es el segundo nivel de detalle después de los metadatos, por lo que Claude accederá a esto si es necesario después de leer los metadatos. Dependiendo de tu tarea, Claude puede acceder al archivo Skill.md y usar la Skill.

Ejemplo de Skill.md

Skill de Directrices de Marca

## Metadatos
name: Directrices de Marca
description: Aplicar las directrices de marca de Acme Corp a todas las presentaciones y documentos
version: 1.0.0

## Descripción general
Esta Skill proporciona las directrices de marca oficiales de Acme Corp para crear materiales consistentes y profesionales. Al crear presentaciones, documentos o materiales de marketing, aplica estos estándares para asegurar que todos los resultados coincidan con la identidad visual de Acme. Claude debe hacer referencia a estas directrices siempre que cree materiales de cara al exterior o documentos que representen a Acme Corp.

## Colores de marca

Nuestros colores de marca oficiales son:
- Primario: #FF6B35 (Coral)
- Secundario: #004E89 (Azul Marino)
- Acento: #F7B801 (Dorado)
- Neutral: #2E2E2E (Carbón)

## Tipografía

Encabezados: Montserrat Bold
Texto del cuerpo: Open Sans Regular
Directrices de tamaño:
- H1: 32pt
- H2: 24pt
- Cuerpo: 11pt

## Uso del logotipo

Siempre usa el logotipo a todo color sobre fondos claros. Usa el logotipo blanco sobre fondos oscuros. Mantén un espaciado mínimo de 0.5 pulgadas alrededor del logotipo.

## Cuándo aplicar

Aplica estas directrices siempre que crees:
- Presentaciones de PowerPoint
- Documentos de Word para compartir externamente
- Materiales de marketing
- Informes para clientes

## Recursos

Consulta la carpeta de recursos para archivos de logotipo y descargas de fuentes.

Agregar recursos

Si tienes demasiada información para agregar a un solo archivo Skill.md (por ejemplo, secciones que solo se aplican a escenarios específicos), puedes agregar más contenido añadiendo archivos dentro de tu directorio de Skill. Por ejemplo, agrega un archivo REFERENCE.md que contenga información suplementaria y de referencia a tu directorio de Skill. Hacer referencia a él en Skill.md ayudará a Claude a decidir si necesita acceder a ese recurso al ejecutar la Skill.

Agregar scripts

Para Skills más avanzadas, adjunta archivos de código ejecutable a Skill.md, permitiendo que Claude ejecute código. Por ejemplo, nuestras skills de documentos usan los siguientes lenguajes de programación y paquetes:

Python (pandas, numpy, matplotlib)
JavaScript/Node.js
Paquetes para ayudar con la edición de archivos
herramientas de visualización

Nota: Claude y Claude Code pueden instalar paquetes de repositorios estándar (Python PyPI, JavaScript npm) al cargar Skills. No es posible instalar paquetes adicionales en tiempo de ejecución con Skills de API—todas las dependencias deben estar preinstaladas en el contenedor.

Empaquetar tu Skill

Una vez que tu carpeta de Skill esté completa:

Asegúrate de que el nombre de la carpeta coincida con el nombre de tu Skill
Crea un archivo ZIP de la carpeta
El ZIP debe contener la carpeta de Skill como su raíz (no una subcarpeta)

Estructura correcta:

mi-Skill.zip

└── mi-Skill/

├── Skill.md

└── resources/

Estructura incorrecta: