Las habilidades están disponibles para usuarios en planes Free, 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 utilicen 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
Grabar una habilidad
La grabación de una habilidad está disponible en planes Pro, Max y Team, en Cowork en Claude para Mac. No está disponible en chat, en Windows, ni en planes Free y Enterprise.
En lugar de escribir una habilidad manualmente, puedes grabarte a ti mismo realizando una tarea y dejar que Claude construya la habilidad a partir de lo que observa. Envías a Claude un video de tu pantalla, clics, escritura y voz, y Claude propone una habilidad para que la revises antes de guardarla.
Antes de grabar
Actualiza a la última versión de Claude para Mac.
Otorga los permisos de macOS que Claude solicita la primera vez que grabas: Accesibilidad para el seguimiento del ratón y el teclado, y Grabación de pantalla para la visibilidad de la pantalla. macOS puede pedirte que reinicies Claude.
Cierra cualquier archivo, aplicación o conversación que no desees que se capture.
Advertencia: No escribas contraseñas o secretos, ni muestres información sensible o conversaciones privadas mientras grabas. Todo lo que aparece en tu pantalla se captura durante toda la sesión, junto con todo lo que digas.
Graba tu flujo de trabajo
Abre Cowork en Claude para Mac.
Inicia una grabación de una de dos formas:
Haz clic en el botón "+" en el compositor y luego selecciona "Grabar una habilidad".
Ve a Personalizar > Habilidades, haz clic en "Añadir" y luego selecciona "Grabar tu pantalla".
Haz clic en "Iniciar grabación". Para narrar mientras trabajas, deja el micrófono activado. Usa el control del micrófono para silenciarlo o elige una entrada diferente.
Realiza la tarea como lo harías normalmente. La barra de captura muestra que la grabación está en progreso y cuenta los pasos que ha capturado.
Haz clic en "Listo" cuando termines, o "Descartar" para eliminar la grabación sin crear nada.
Una grabación puede durar aproximadamente 10 minutos. Una cuenta atrás aparece en la barra de captura cuando te quedan aproximadamente un minuto. Cuando llega a cero, la grabación se detiene y todo lo que hayas capturado hasta ese momento se envía a Claude, igual que si hubieras hecho clic en "Listo".
Consejo: Habla sobre lo que estás haciendo mientras grabas. La narración le da a Claude contexto que no puede obtener solo de tu pantalla, como por qué omites un paso o cómo eliges entre dos opciones.
Qué sucede después de hacer clic en Listo
Claude inicia una tarea de Cowork y revisa la grabación, luego propone una habilidad. Dependiendo de lo que encuentre, verás una de dos cosas:
Una nueva habilidad, marcada como NUEVA en la tarjeta de propuesta. Haz clic en "Guardar" para mantenerla, o "Descartar" para rechazar la propuesta.
Una actualización de una habilidad existente. Si la grabación se superpone con una habilidad que ya tienes, Claude propone cambios en esa habilidad en su lugar. La tarjeta muestra en qué habilidad se basa la propuesta. Haz clic en "Actualizar" para aplicar los cambios, o "Descartar" para rechazarlos.
Expande Contenido en la tarjeta de propuesta para leer la habilidad antes de decidir.
Las habilidades que guardas desde una grabación aparecen en Personalizar > Habilidades y funcionan como cualquier otra habilidad. Puedes editarlas, compartirlas y eliminarlas en los mismos términos.
Qué se conserva de una grabación
El video y el audio de tu grabación no se conservan. Después de enviar tu grabación a Claude, Claude revisa la grabación para construir la habilidad. Lo que se guarda después es un conjunto de capturas de pantalla de la sesión, que puedes ver expandiendo el paso Demostración grabada en la tarea.
Debido a que esas capturas de pantalla se encuentran en la tarea de Cowork, eliminar la tarea las elimina. Consulta Introducción a Claude Cowork para saber cómo funcionan la eliminación y retención de tareas.
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 directrices de marca de Acme Corp a presentaciones y documentos, incluidos colores oficiales, fuentes y uso del logotipo.
Campos de metadatos opcionales
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 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 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
## 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 aplican a escenarios específicos), puedes agregar más contenido añadiendo 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 como 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 claridad.
2. Verifica que la descripción refleje con precisión cuándo Claude debe usar la habilidad.
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 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 usa cuando se espera.
Cuando estés iterando en una habilidad con Claude en el chat, puedes editar los archivos de habilidades directamente donde se abren junto a la conversación. Resalta el texto que deseas cambiar, haz clic en "Editar con Claude" y escribe tu solicitud. Para habilidades con múltiples archivos, deja solicitudes de edición en los archivos y envíalas juntas, y Claude las aplica en un solo paso. Obtén más información sobre editar artefactos.
Nota para planes Team y Enterprise: Para poner una habilidad a disposición de 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 aplica.
Comienza simple: Empieza con instrucciones básicas en Markdown antes de agregar scripts complejos. Siempre puedes expandir la habilidad 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 habilidad compleja de una sola vez.
Las habilidades pueden construirse unas sobre otras: Aunque las habilidades no pueden referenciar explícitamente otras habilidades, Claude puede usar múltiples habilidades juntas automáticamente. Esta composabilidad es una de las partes más poderosas de la característica 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 API, contraseñas).
Revisa cualquier habilidad que descargues antes de habilitarla.
Utiliza conexiones MCP apropiadas para acceder a servicios externos.
Habilidades de ejemplo para consultar
Visita nuestro repositorio en GitHub para ver habilidades de ejemplo que puedes usar como plantillas: https://github.com/anthropics/skills/tree/main/skills.