Las Habilidades 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 Habilidades.
Las Habilidades 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 Habilidades:
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 Habilidad consiste en un directorio que contiene como mínimo un archivo Skill.md, que es el núcleo de la Habilidad. 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 Habilidad (máximo 64 caracteres)
Ejemplo: Directrices de Marca
description: Una descripción clara de qué hace la Habilidad y cuándo usarla.
Esto es crítico—Claude usa esto para determinar cuándo invocar tu Habilidad (máximo 200 caracteres).
Ejemplo: Aplicar las directrices de marca de Acme Corp a presentaciones y documentos, incluyendo colores oficiales, fuentes y uso del logo.
Campos de Metadatos Opcionales
version: Realiza un seguimiento de las versiones de tu Habilidad a medida que iteras.
Ejemplo: 1.0.0
dependencies: Paquetes de software requeridos por tu Habilidad.
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 información suficiente para que Claude sepa cuándo debe usarse la Habilidad sin tener que cargar todo el contenido.
Cuerpo Markdown
El cuerpo 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 Habilidad.
Ejemplo Skill.md
Habilidad 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 Habilidad 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:
- Primario: #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 Logo
Siempre usa el logo a todo color en fondos claros. Usa el logo blanco en fondos oscuros. Mantén un espaciado mínimo de 0.5 pulgadas alrededor del logo.
## Cuándo Aplicar
Aplica estas directrices siempre que crees:
- Presentaciones de PowerPoint
- Documentos de Word para compartir externamente
- Materiales de marketing
- Reportes para clientes
## Recursos
Consulta la carpeta de recursos para archivos de logo y descargas de fuentes.
Agregar Recursos
Si tienes demasiada información para agregar a un único archivo Skill.md (por ejemplo, secciones que solo aplican a escenarios específicos), puedes agregar más contenido añadiendo archivos dentro de tu directorio de Habilidad. Por ejemplo, agrega un archivo REFERENCE.md que contenga información complementaria y de referencia a tu directorio de Habilidad. Hacer referencia a él en Skill.md ayudará a Claude a decidir si necesita acceder a ese recurso al ejecutar la Habilidad.
Agregar Scripts
Para Habilidades más avanzadas, adjunta archivos de código ejecutable a Skill.md, permitiendo que Claude ejecute código. Por ejemplo, nuestras habilidades 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 Habilidades. No es posible instalar paquetes adicionales en tiempo de ejecución con Habilidades de API—todas las dependencias deben estar preinstaladas en el contenedor.
Empaquetar tu Habilidad
Una vez que tu carpeta de Habilidad esté completa:
Asegúrate de que el nombre de la carpeta coincida con el nombre de tu Habilidad
Crea un archivo ZIP de la carpeta
El ZIP debe contener la carpeta de Habilidad como su raíz (no como una subcarpeta)
Estructura correcta:
mi-Habilidad.zip
└── mi-Habilidad/
├── Skill.md
└── recursos/
Estructura incorrecta