Agent Skills



Por qué usar Skills

Las Skills son recursos reutilizables basados en el sistema de archivos que proporcionan a Claude experiencia específica de dominio: flujos de trabajo, contexto y mejores prácticas que transforman agentes de propósito general en especialistas. A diferencia de los prompts (instrucciones a nivel de conversación para tareas puntuales), las Skills se cargan bajo demanda y eliminan la necesidad de proporcionar repetidamente la misma orientación en múltiples conversaciones.

Beneficios clave:

• Especializar a Claude: Adapta las capacidades para tareas específicas de dominio
• Reducir la repetición: Crea una vez, usa automáticamente
• Componer capacidades: Combina Skills para construir flujos de trabajo complejos



Uso de Skills

Anthropic proporciona Agent Skills predefinidas para tareas comunes de documentos (PowerPoint, Excel, Word, PDF), y 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 predefinidas están disponibles en claude.ai, la API de Claude, Claude Platform on AWS y Microsoft Foundry. En Microsoft Foundry, las Agent Skills requieren una implementación Hosted on Anthropic. Consulta Skills disponibles para ver la lista completa.

Las Skills personalizadas te permiten empaquetar experiencia de dominio y conocimiento organizacional. Están disponibles en todos los productos de Claude: créalas en Claude Code, súbelas a través de la API de Claude o agrégalas en la configuración de claude.ai. En Claude Platform on AWS y Microsoft Foundry, sube Skills personalizadas a través de la Skills API.



Cómo funcionan las Skills

Las Skills aprovechan el entorno de máquina virtual 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 las Skills existan como directorios que contienen instrucciones, código ejecutable y materiales de referencia, organizados como una guía de incorporación que crearías para un nuevo miembro del equipo.

Esta arquitectura basada en el sistema de archivos permite la "progressive disclosure" (divulgación progresiva): Claude carga información por etapas según sea necesario, en lugar de consumir contexto desde el inicio.



Tres tipos de contenido de Skill, tres niveles de carga

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



Nivel 1: Metadatos (siempre cargados)

Tipo de contenido: Instrucciones. El frontmatter YAML de la Skill proporciona información de descubrimiento:

---
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 la indicación del sistema. Este enfoque ligero significa que puedes instalar muchas Skills sin penalización de contexto; Claude solo sabe que cada Skill existe y cuándo usarla.



Nivel 2: Instrucciones (cargadas cuando se activan)

Tipo de contenido: Instrucciones. El cuerpo principal de SKILL.md contiene conocimiento procedimental: flujos de trabajo, mejores prácticas y orientación:

# 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 (cargados según sea necesario)

Tipos de contenido: Instrucciones, código y recursos. Las Skills pueden incluir 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 orientación especializada y flujos de trabajo

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

Recursos: Materiales de referencia como esquemas de bases de datos, documentación de API, plantillas o ejemplos

Claude accede a estos archivos solo cuando se hace referencia a ellos. El modelo de sistema de archivos significa que cada tipo de contenido tiene diferentes fortalezas: instrucciones para orientación flexible, código para confiabilidad, recursos para consulta de datos.

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



La arquitectura de Skills

Las 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. Piénsalo 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 las Skills:

Cuando se activa una Skill, Claude usa bash para leer SKILL.md desde el sistema de archivos, incorporando 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 lee esos archivos usando comandos bash adicionales. Cuando las instrucciones mencionan scripts ejecutables, Claude los ejecuta mediante bash y recibe solo la salida (el código del script en sí 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 docenas 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 consumiendo cero tokens.

Ejecución eficiente de scripts: Cuando Claude ejecuta validate_form.py, el código del script nunca se carga en la ventana de contexto. Solo la salida del script (como "Validación exitosa" o mensajes de error específicos) consume tokens. Esto hace que los scripts sean mucho más eficientes que hacer que Claude genere código equivalente sobre la marcha.

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

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



Ejemplo: Carga de una skill de procesamiento de PDF

Así es como Claude carga y usa una skill de procesamiento de PDF:

1. Inicio: La indicación 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 → Instrucciones cargadas en el contexto
4. Claude determina: No se necesita llenar formularios, por lo que no se lee FORMS.md
5. Claude ejecuta: Usa las instrucciones de SKILL.md para completar la tarea

El diagrama muestra:

1. Estado predeterminado con la indicación del sistema y los metadatos de la skill precargados
2. Claude activa la skill leyendo SKILL.md mediante bash
3. Claude opcionalmente lee archivos adicionales incluidos como FORMS.md según sea necesario
4. Claude procede con la tarea

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



Dónde funcionan las Skills

Las Skills están disponibles en todos los productos de agentes de Claude:



API de Claude

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

Requisitos previos: Usar Skills a través de la API requiere tres encabezados beta:

• code-execution-2025-08-25 - Las 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 - Requerido para subir/descargar archivos hacia/desde el contenedor

Usa Agent Skills predefinidas haciendo referencia a su skill_id (por ejemplo, pptx, xlsx), o crea y sube las tuyas propias a través de la Skills API (endpoints /v1/skills). Las Skills personalizadas se comparten en todo el espacio de trabajo; todos los miembros del espacio de trabajo pueden acceder a ellas.

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



Claude Code

Claude Code solo admite Skills personalizadas.

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

Las Skills personalizadas en Claude Code están basadas en el sistema de archivos y no requieren cargas a la API.

Para obtener más información, consulta Usar Skills en Claude Code.



claude.ai

claude.ai admite tanto Agent Skills predefinidas como Skills personalizadas.

Agent Skills predefinidas: Estas Skills ya están funcionando en segundo plano cuando creas documentos. Claude las usa sin requerir ninguna configuración.

Skills personalizadas: Sube tus propias Skills como archivos zip a través de Configuración > Funciones. Disponible en los planes Pro, Max, Team y Enterprise con la ejecución de código habilitada. Las Skills personalizadas son individuales para cada usuario; no se comparten en toda la organización y no pueden ser gestionadas centralmente por administradores.

Para obtener más información sobre el uso de Skills en claude.ai, consulta los siguientes recursos en el Centro de ayuda de Claude:

• ¿Qué son las Skills?
• Uso de Skills en Claude
• Cómo crear Skills personalizadas
• Enseña a Claude tu forma de trabajar usando Skills



Estructura de una Skill

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

---
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

Requisitos de los campos:

name:

• Máximo 64 caracteres
• Debe contener solo letras minúsculas, números y guiones
• No puede contener etiquetas XML
• No puede contener palabras reservadas: "anthropic", "claude"

description:

• No debe estar vacío
• Máximo 1024 caracteres
• No puede contener etiquetas XML

El campo description debe incluir tanto lo que hace la Skill como cuándo debe usarla Claude. Para obtener orientación completa sobre la creación, consulta la guía de mejores prácticas.



Consideraciones de seguridad

Usa Skills solo de fuentes confiables: aquellas que creaste tú mismo o que obtuviste de Anthropic. Las Skills proporcionan a Claude nuevas capacidades a través de instrucciones y código, y aunque esto las hace poderosas, también significa que una Skill maliciosa puede dirigir a Claude a invocar herramientas o ejecutar código de maneras que no coinciden con el propósito declarado de la Skill.

Consideraciones clave de seguridad:

• Audita exhaustivamente: Revisa todos los archivos incluidos 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 de la Skill
• Las fuentes externas son riesgosas: Las Skills que obtienen datos de URLs externas representan un riesgo particular, ya que el contenido obtenido puede contener instrucciones maliciosas. Incluso las 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 maneras 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 instalar software: Usa solo 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 predefinidas

Las siguientes Agent Skills predefinidas están disponibles para uso inmediato:

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

Estas Skills están disponibles en la API de Claude, Claude Platform on AWS, Microsoft Foundry y claude.ai. En Microsoft Foundry, las Agent Skills requieren una implementación Hosted on Anthropic. Consulta el tutorial de inicio rápido para comenzar a usarlas en la API.



Skills de código abierto

Anthropic también publica Skills de código abierto en el repositorio de skills:

• Claude API: Proporciona a Claude material de referencia actualizado de la API, documentación de SDK y mejores prácticas para 8 lenguajes de programación. Incluida con Claude Code y también disponible para instalación desde el repositorio de skills.



Ejemplos de Skills personalizadas

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



Retención de datos

Agent Skills no está cubierto por los acuerdos de ZDR. Las definiciones de Skills y los datos de ejecución se retienen de acuerdo con la política estándar de retención de datos de Anthropic.

Para conocer la elegibilidad de ZDR en todas las funciones, consulta API y retención de datos.



Limitaciones y restricciones

Comprender estas limitaciones te ayuda a planificar tu implementación de Skills de manera efectiva. Claude Platform on AWS y Microsoft Foundry siguen las mismas limitaciones que la API de Claude en las siguientes subsecciones.



Disponibilidad entre superficies

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

• Las Skills subidas a claude.ai deben subirse por separado a la API
• Las Skills subidas a través de la API no están disponibles en claude.ai
• Las Skills de Claude Code están basadas en el sistema de archivos y son independientes tanto de claude.ai como de la API

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



Alcance de compartición

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

• claude.ai: Solo usuario individual; cada miembro del equipo debe subirlas por separado
• API de Claude: En todo el espacio de trabajo; todos los miembros del espacio de trabajo pueden acceder a las Skills subidas
• Claude Code: Personal (~/.claude/skills/) o basado en proyecto (.claude/skills/); también se pueden compartir mediante Claude Code Plugins

claude.ai no admite la gestión centralizada por administradores ni la distribución a nivel de organización de Skills personalizadas.



Restricciones del entorno de ejecución

El entorno de ejecución exacto disponible para tu skill depende de la superficie del producto donde la uses.

• claude.ai:
  • Acceso a red variable: Dependiendo de la configuración del usuario/administrador, las Skills pueden tener acceso completo, parcial o nulo a la red. Para más detalles, consulta el artículo de soporte Crear y editar archivos.
• API de Claude:
  • Sin acceso a red: Las Skills no pueden realizar 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
• Claude Code:
  • Acceso completo a red: Las Skills tienen el mismo acceso a red que cualquier otro programa en la computadora del usuario
  • Se desaconseja la instalación global de paquetes: Las Skills solo deben instalar paquetes localmente para evitar interferir con la computadora del usuario

Planifica tus Skills para que funcionen dentro de estas restricciones.



Próximos pasos