Las Skills están disponibles para usuarios en planes Pro, Max, Team y Enterprise. Esta función requiere que la ejecución de código esté habilitada. Las Skills también están disponibles en versión beta para usuarios de Claude Code y para todos los usuarios de API que utilizan la herramienta de ejecución de código.
Las Skills personalizadas te permiten mejorar Claude con conocimientos especializados y flujos de trabajo específicos para 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 algunas 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 hacerlo 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 amigable para tu Skill (máximo 64 caracteres)
Ejemplo: Directrices de marca
description: Una descripción clara de qué 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
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 solo la información suficiente para que Claude sepa cuándo debe usarse la Skill sin tener que cargar todo el contenido.
Cuerpo de Markdown
El cuerpo de 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
## 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 dirigidos al público externo o documentos que representen a Acme Corp.
## Colores de marca
Nuestros colores de marca oficiales son:
- Principal: #FF6B35 (Coral)
- Secundario: #004E89 (Azul marino)
- Acento: #F7B801 (Oro)
- Neutro: #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 en fondos claros. Usa el logotipo blanco en 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 único 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 complementaria 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 utilizan 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 como una subcarpeta).
Estructura correcta:
mi-Skill.zip
└── mi-Skill/
├── Skill.md
└── recursos/
Estructura incorrecta:
mi-Skill.zip
└── (archivos directamente en la raíz del ZIP)
Probar tu Skill
Antes de cargar
1. Revisa tu Skill.md para claridad
2. Verifica que la descripción refleje con precisión cuándo Claude debe usar la Skill
3. Confirma que todos los archivos referenciados existan en las ubicaciones correctas
4. Prueba con indicaciones de ejemplo para asegurar que Claude la invoque apropiadamente
Después de cargar a Claude
1. Habilita la Skill en Configuración > Capacidades.
2. Prueba con varios indicaciones diferentes que deberían activarla
3. Revisa el pensamiento de Claude para confirmar que está cargando la Skill
4. Itera en la descripción si Claude no la usa cuando se espera
Nota para planes Team y Enterprise: Para poner una skill a disposición de todos los usuarios en tu organización, consulta Provisioning and managing Skills for your organization.
Mejores prácticas
Mantenlo enfocado: Crea Skills separadas para diferentes flujos de trabajo. Múltiples Skills enfocadas se componen mejor que una Skill grande.
Escribe descripciones claras: Claude usa descripciones para decidir cuándo invocar tu Skill. Sé específico sobre cuándo se aplica.
Comienza simple: Comienza con instrucciones básicas en Markdown antes de agregar scripts complejos. Siempre puedes expandir la Skill más tarde.
Usa ejemplos: Incluye entradas y salidas de ejemplo en tu archivo Skill.md para ayudar a Claude a entender cómo se ve el éxito.
Prueba incrementalmente: Prueba después de cada cambio significativo en lugar de construir una Skill compleja de una sola vez.
Las Skills pueden construirse una sobre la otra: Aunque las Skills no pueden hacer referencia explícitamente a otras Skills, Claude puede usar múltiples Skills juntas automáticamente. Esta composabilidad es una de las partes más poderosas de la función de Skills.
Revisa la especificación abierta de Agent Skills: Sigue las directrices en agentskills.io, para que las skills que crees puedan funcionar en plataformas que adopten el estándar.
Para una guía más detallada sobre la creación de skills, consulta Skill authoring best practices en nuestros Claude Docs.
Consideraciones de seguridad
Ejerce precaución al agregar scripts a tu archivo Skill.md.
No codifiques información sensible (claves de API, contraseñas).
Revisa cualquier Skill que descargues antes de habilitarla.
Usa conexiones MCP apropiadas para acceso a servicios externos.
Skills de ejemplo para consultar
Visita nuestro repositorio en GitHub para Skills de ejemplo que puedes usar como plantillas: https://github.com/anthropics/skills/tree/main/skills.