Resumen

Por qué usar Skills

Skills son recursos reutilizables basados en el sistema de archivos que proporcionan a Claude experiencia específica de un dominio: flujos de trabajo, contexto y buenas prácticas que convierten a agentes generales en especialistas. A diferencia de los prompts, que son instrucciones de una conversación para tareas puntuales, Skills se cargan bajo demanda y evitan tener que repetir la misma guía en varias conversaciones.

Beneficios clave:

• Especializar a Claude: Ajusta sus capacidades para tareas de dominio específico
• Reducir repetición: Crea una vez y reutiliza automáticamente
• Combinar capacidades: Combina Skills para construir flujos de trabajo complejos

Uso de Skills

Anthropic proporciona Agent Skills prediseñadas para tareas habituales con documentos (PowerPoint, Excel, Word y PDF), y también puedes crear tus propias Skills personalizadas. Ambas funcionan de la misma manera. Claude las usa automáticamente cuando son relevantes para tu solicitud.

Las Agent Skills prediseñadas están disponibles para todos los usuarios en claude.ai y mediante la Claude API. Consulta la sección Skills disponibles para ver la lista completa.

Las Skills personalizadas te permiten empaquetar experiencia de dominio y conocimiento organizacional. Están disponibles en los productos de Claude: puedes crearlas en Claude Code, subirlas mediante la API o añadirlas desde la configuración de claude.ai.

Cómo funcionan Skills

Skills aprovechan el entorno de VM de Claude para proporcionar capacidades que van más allá de lo que es posible solo con prompts. Claude opera en una máquina virtual con acceso al sistema de archivos, lo que permite que Skills existan como directorios que contienen instrucciones, código ejecutable y materiales de referencia, organizados como una guía de incorporación para una nueva persona del equipo.

Esta arquitectura basada en el sistema de archivos permite la divulgación progresiva: Claude carga la información por etapas, según la necesita, en lugar de consumir contexto desde el inicio.

Tres tipos de contenido de Skill, tres niveles de carga

Skills pueden contener tres tipos de contenido, cada uno cargado en momentos distintos:

Nivel 1: Metadatos (siempre cargados)

Tipo de contenido: instrucciones. El YAML frontmatter de la Skill proporciona información para descubrirla:

---
name: PDF Processing
description: Extract text and tables from PDF files, fill forms, merge documents. Use when working with PDF files or when the user mentions PDFs, forms, or document extraction.
---

Claude carga estos metadatos al inicio y los incluye en el prompt del sistema. Este enfoque ligero permite instalar muchas Skills sin penalización de contexto; Claude solo sabe que cada Skill existe y cuándo debe usarla.

Nivel 2: Instrucciones (se cargan cuando se activan)

Tipo de contenido: instrucciones. El cuerpo principal de SKILL.md contiene conocimiento procedimental: flujos de trabajo, buenas prácticas y guía:

# PDF Processing

## Quick start

Use pdfplumber to extract text from PDFs:
```python
import pdfplumber

with pdfplumber.open("document.pdf") as pdf:
    text = pdf.pages[0].extract_text()
```

For advanced form filling, see [FORMS.md](FORMS.md).

Cuando solicitas algo que coincide con la descripción de una Skill, Claude lee SKILL.md desde el sistema de archivos mediante bash. Solo entonces este contenido entra en la ventana de contexto.

Nivel 3: Recursos y código (se cargan según sea necesario)

Tipos de contenido: instrucciones, código y recursos. Skills pueden empaquetar materiales adicionales:

pdf-skill/
|-- SKILL.md (main instructions)
|-- FORMS.md (form-filling guide)
|-- REFERENCE.md (detailed API reference)
`-- scripts/
  `-- fill_form.py (utility script)

Instrucciones: archivos Markdown adicionales (FORMS.md, REFERENCE.md) que contienen guía especializada y flujos de trabajo.

Código: scripts ejecutables (fill_form.py, validate.py) que Claude ejecuta mediante bash; los scripts ofrecen operaciones deterministas sin consumir contexto.

Recursos: materiales de referencia como esquemas de base de datos, documentación de API, plantillas o ejemplos.

Claude accede a estos archivos solo cuando se referencian. El modelo de sistema de archivos significa que cada tipo de contenido tiene fortalezas distintas: instrucciones para guía flexible, código para fiabilidad y recursos para consultas factuales.

La divulgación progresiva garantiza que solo el contenido relevante ocupe la ventana de contexto en cada momento.

Arquitectura de Skills

Skills se ejecutan en un entorno de ejecución de código donde Claude tiene acceso al sistema de archivos, comandos bash y capacidades de ejecución de código. Piensa en ello así: las Skills existen como directorios en una máquina virtual, y Claude interactúa con ellas usando los mismos comandos bash que usarías para navegar archivos en tu computadora.

Cómo accede Claude al contenido de una Skill:

Cuando se activa una Skill, Claude usa bash para leer SKILL.md desde el sistema de archivos y llevar sus instrucciones a la ventana de contexto. Si esas instrucciones hacen referencia a otros archivos, como FORMS.md o un esquema de base de datos, Claude también los lee con comandos bash adicionales. Cuando las instrucciones mencionan scripts ejecutables, Claude los ejecuta mediante bash y recibe solo la salida; el código del script nunca entra en el contexto.

Qué permite esta arquitectura:

Acceso a archivos bajo demanda: Claude lee solo los archivos necesarios para cada tarea específica. Una Skill puede incluir decenas de archivos de referencia, pero si tu tarea solo necesita el esquema de ventas, Claude carga solo ese archivo. El resto permanece en el sistema de archivos y consume cero tokens.

Ejecución eficiente de scripts: Cuando Claude ejecuta validate_form.py, el código del script no se carga en la ventana de contexto. Solo la salida del script, como "Validation passed" o mensajes de error concretos, consume tokens. Esto hace que los scripts sean mucho más eficientes que pedirle a Claude que genere código equivalente en el momento.

Sin límite práctico para el contenido empaquetado: Como los archivos no consumen contexto hasta que se accede a ellos, Skills pueden incluir documentación completa de API, grandes conjuntos de datos, muchos ejemplos o cualquier material de referencia necesario. No hay penalización de contexto por el contenido empaquetado que no se usa.

Este modelo basado en el sistema de archivos es lo que hace funcionar la divulgación progresiva. Claude navega tu Skill como consultarías secciones concretas de una guía de incorporación, accediendo exactamente a lo que requiere cada tarea.

Ejemplo: cargar una Skill de procesamiento de PDF

Así carga y usa Claude una Skill de procesamiento de PDF:

1. Inicio: el prompt del sistema incluye PDF Processing - Extract text and tables from PDF files, fill forms, merge documents
2. Solicitud del usuario: "Extrae el texto de este PDF y resúmelo"
3. Claude invoca: bash: read pdf-skill/SKILL.md -> las instrucciones se cargan en el contexto
4. Claude determina: no se necesita rellenar formularios, así que no lee FORMS.md
5. Claude ejecuta: usa las instrucciones de SKILL.md para completar la tarea

El diagrama muestra:

1. Estado predeterminado con el prompt del sistema y los metadatos de Skill precargados
2. Claude activa la Skill leyendo SKILL.md mediante bash
3. Claude lee opcionalmente archivos empaquetados adicionales como FORMS.md cuando son necesarios
4. Claude continúa con la tarea

Esta carga dinámica garantiza que solo el contenido relevante de la Skill ocupe la ventana de contexto.

Dónde funcionan Skills

Skills están disponibles en los productos de agente de Claude:

Claude API

Claude API admite tanto Agent Skills prediseñadas como Skills personalizadas. Ambas funcionan de forma idéntica: especifica el skill_id relevante en el parámetro container junto con la herramienta de ejecución de código.

Requisitos previos: Para usar Skills mediante la API se requieren tres encabezados beta:

• code-execution-2025-08-25 - Skills se ejecutan en el contenedor de ejecución de código
• skills-2025-10-02 - Habilita la funcionalidad de Skills
• files-api-2025-04-14 - Necesario para subir y descargar archivos hacia o desde el contenedor

Usa Agent Skills prediseñadas haciendo referencia a su skill_id (por ejemplo, pptx, xlsx), o crea y sube las tuyas mediante la Skills API (endpoints /v1/skills). Las Skills personalizadas se comparten en toda la organización.

Para obtener más información, consulta Usar Skills con Claude API.

Claude Code

Claude Code solo admite Skills personalizadas.

Skills personalizadas: crea Skills como directorios con archivos SKILL.md. Claude las descubre y las usa automáticamente.

Las Skills personalizadas en Claude Code se basan en el sistema de archivos y no requieren subidas a la API.

Para saber más, consulta Usar Skills en Claude Code.

Claude.ai

Claude.ai admite tanto Agent Skills prediseñadas como Skills personalizadas.

Agent Skills prediseñadas: estas Skills ya funcionan entre bastidores cuando creas documentos. Claude las usa sin que tengas que configurar nada.

Skills personalizadas: sube tus propias Skills como archivos zip desde Settings > Features. Están disponibles en los planes Pro, Max, Team y Enterprise con ejecución de código habilitada. Las Skills personalizadas son individuales para cada usuario; no se comparten en toda la organización y los administradores no pueden gestionarlas de forma centralizada.

Para saber más sobre Skills en Claude.ai, consulta estos recursos del Claude Help Center:

• What are Skills?
• Using Skills in Claude
• How to create custom Skills
• Tech Claude your way of working using Skills

Estructura de una Skill

Cada Skill requiere un archivo SKILL.md con YAML frontmatter:

---
name: Your Skill Name
description: Brief description of what this Skill does and when to use it
---

# Your Skill Name

## Instructions
[Clear, step-by-step guidance for Claude to follow]

## Examples
[Concrete examples of using this Skill]

Campos obligatorios: name y description

Estos son los únicos dos campos compatibles en el YAML frontmatter.

Límites del frontmatter:

• name: máximo 64 caracteres
• description: máximo 1024 caracteres

La description debe incluir tanto lo que hace la Skill como cuándo Claude debería usarla. Para una guía completa de autoría, consulta la guía de buenas prácticas.

Consideraciones de seguridad

Recomendamos firmemente usar Skills solo de fuentes confiables: las que hayas creado tú mismo o las que hayas obtenido de Anthropic. Skills dan a Claude nuevas capacidades mediante instrucciones y código; esto las hace potentes, pero también significa que una Skill maliciosa puede dirigir a Claude para invocar herramientas o ejecutar código de maneras que no coinciden con el propósito declarado de la Skill.

Consideraciones clave de seguridad:

• Audita a fondo: revisa todos los archivos empaquetados en la Skill: SKILL.md, scripts, imágenes y otros recursos. Busca patrones inusuales, como llamadas de red inesperadas, patrones de acceso a archivos u operaciones que no coincidan con el propósito declarado
• Las fuentes externas son riesgosas: las Skills que obtienen datos de URL externas suponen un riesgo particular, porque el contenido obtenido puede contener instrucciones maliciosas. Incluso Skills confiables pueden verse comprometidas si sus dependencias externas cambian con el tiempo
• Uso indebido de herramientas: las Skills maliciosas pueden invocar herramientas (operaciones de archivos, comandos bash, ejecución de código) de formas dañinas
• Exposición de datos: las Skills con acceso a datos sensibles podrían estar diseñadas para filtrar información a sistemas externos
• Trátalas como instalación de software: usa únicamente Skills de fuentes confiables. Ten especial cuidado al integrar Skills en sistemas de producción con acceso a datos sensibles u operaciones críticas

Skills disponibles

Agent Skills prediseñadas

Las siguientes Agent Skills prediseñadas están disponibles para uso inmediato:

• PowerPoint (pptx): crear presentaciones, editar diapositivas y analizar contenido de presentaciones
• Excel (xlsx): crear hojas de cálculo, analizar datos y generar informes con gráficos
• Word (docx): crear documentos, editar contenido y dar formato al texto
• PDF (pdf): generar documentos e informes PDF con formato

Estas Skills están disponibles en Claude API y claude.ai. Consulta el tutorial de inicio rápido para empezar a usarlas en la API.

Ejemplos de Skills personalizadas

Para ver ejemplos completos de Skills personalizadas, consulta el Skills cookbook.

Limitaciones y restricciones

Entender estas limitaciones te ayuda a planificar eficazmente el despliegue de tus Skills.

Disponibilidad entre superficies

Las Skills personalizadas no se sincronizan entre superficies. Las Skills subidas a una superficie no quedan disponibles automáticamente en otras:

• Las Skills subidas a Claude.ai deben subirse por separado a la API
• Las Skills subidas mediante la API no están disponibles en Claude.ai
• Las Skills de Claude Code se basan en el sistema de archivos y están separadas tanto de Claude.ai como de la API

Deberás gestionar y subir Skills por separado para cada superficie donde quieras usarlas.

Alcance de compartición

Skills tienen distintos modelos de compartición según dónde las uses:

• Claude.ai: solo usuario individual; cada miembro del equipo debe subirlas por separado
• Claude API: todo el workspace; todos los miembros del workspace pueden acceder a las Skills subidas
• Claude Code: personal (~/.claude/skills/) o basado en proyecto (.claude/skills/)

Claude.ai actualmente no admite gestión administrativa centralizada ni distribución de Skills personalizadas para toda la organización.

Restricciones del entorno de ejecución

Skills se ejecutan en el contenedor de ejecución de código con estas limitaciones:

• Sin acceso a red: Skills no pueden hacer llamadas a API externas ni acceder a internet
• Sin instalación de paquetes en tiempo de ejecución: solo están disponibles los paquetes preinstalados. No puedes instalar nuevos paquetes durante la ejecución
• Solo dependencias preconfiguradas: consulta la documentación de la herramienta de ejecución de código para ver la lista de paquetes disponibles

Planifica tus Skills para que funcionen dentro de estas restricciones.

Siguientes pasos