Las habilidades están disponibles para usuarios en planes gratuito, Pro, Max, Team y Enterprise. Esta función requiere que la ejecución de código esté habilitada. Las habilidades 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 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 centran 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
nombre: Un nombre amigable para el usuario para tu habilidad (máximo 64 caracteres)
Ejemplo: Directrices de marca
descripción: 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, incluidos colores oficiales, fuentes y uso del logotipo.
Campos de metadatos opcionales
dependencias: 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 solo la información suficiente para que Claude sepa cuándo se debe usar la habilidad 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 habilidad.
Ejemplo de skill.md
Habilidad de directrices de marca
## Metadata
name: Brand Guidelines
description: Apply Acme Corp brand guidelines to all presentations and documents
## Overview
This skill provides Acme Corp's official brand guidelines for creating consistent, professional materials. When creating presentations, documents, or marketing materials, apply these standards to ensure all outputs match Acme's visual identity. Claude should reference these guidelines whenever creating external-facing materials or documents that represent Acme Corp.
## Brand Colors
Our official brand colors are:
- Primary: #FF6B35 (Coral)
- Secondary: #004E89 (Navy Blue)
- Accent: #F7B801 (Gold)
- Neutral: #2E2E2E (Charcoal)
## Typography
Headers: Montserrat Bold
Body text: Open Sans Regular
Size guidelines:
- H1: 32pt
- H2: 24pt
- Body: 11pt
## Logo Usage
Always use the full-color logo on light backgrounds. Use the white logo on dark backgrounds. Maintain minimum spacing of 0.5 inches around the logo.
## When to Apply
Apply these guidelines whenever creating:
- PowerPoint presentations
- Word documents for external sharing
- Marketing materials
- Reports for clients
## Resources
See the resources folder for logo files and font downloads.
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 agregando archivos dentro de tu directorio de habilidades. Por ejemplo, agrega un archivo REFERENCE.md que contenga información complementaria y de referencia a tu directorio de habilidades. Referenciarlo 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 API Skills: todas las dependencias deben estar preinstaladas en el contenedor.
Empaquetar tu habilidad
Una vez que tu carpeta de habilidades 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 habilidades como su raíz (no una subcarpeta).
Estructura correcta:
my-skill.zip
└── my-skill/
├── skill.md
└── resources/
Estructura incorrecta:
my-skill.zip
└── (archivos directamente en la raíz del ZIP)
Prueba tu habilidad
Antes de cargar
1. Revisa tu skill.md para mayor claridad.
2. Verifica que la descripción refleje con precisión cuándo Claude debe usar la habilidad.
3. Verifica 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 habilidad en Personalizar > Habilidades.
2. Prueba con varios indicaciones diferentes que deberían activarla.
3. Revisa el pensamiento de Claude para confirmar que está cargando la habilidad.
4. Itera en la descripción si Claude no la está usando cuando se espera.
Nota para planes Team y Enterprise: Para que una habilidad esté disponible para todos los usuarios en tu organización, consulta Provisionar y gestionar habilidades para tu organización.
Mejores prácticas
Mantenlo enfocado: Crea habilidades separadas para diferentes flujos de trabajo. Múltiples habilidades enfocadas se componen mejor que una habilidad grande.
Escribe descripciones claras: Claude usa descripciones para decidir cuándo invocar tu habilidad. 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 habilidad más tarde.
Usa ejemplos: Incluye ejemplos de entrada y salida en tu archivo skill.md para ayudar a Claude a entender qué se ve como éxito.
Prueba incrementalmente: Prueba después de cada cambio significativo en lugar de construir una habilidad compleja de una sola vez.
Las habilidades pueden construirse unas sobre otras: Aunque las habilidades no pueden hacer referencia explícitamente a otras habilidades, Claude puede usar múltiples habilidades juntas automáticamente. Esta composabilidad es una de las partes más poderosas de la función de habilidades.
Revisa la especificación abierta de Agent Skills: Sigue las directrices en agentskills.io, para que las habilidades que crees puedan funcionar en plataformas que adopten el estándar.
Para una guía más detallada sobre la creación de habilidades, consulta Mejores prácticas de autoría de habilidades en nuestros Documentos de Claude.
Consideraciones de seguridad
Ten cuidado al agregar scripts a tu archivo skill.md.
No codifiques información sensible (claves de API, contraseñas).
Revisa cualquier habilidad que descargues antes de habilitarla.
Usa conexiones MCP apropiadas para acceso a servicios externos.
Habilidades de ejemplo para consultar
Visita nuestro repositorio en GitHub para habilidades de ejemplo que puedas usar como plantillas: https://github.com/anthropics/skills/tree/main/skills.