Agent Skills



Por qué usar Skills

Las Skills son recursos reutilizables basados en el sistema de archivos que le dan a Claude experiencia específica de dominio: flujos de trabajo, contexto y mejores prácticas que convierten a un agente de propósito general en un especialista. A diferencia de los prompts (instrucciones a nivel de conversación para tareas puntuales), las Skills se cargan bajo demanda, por lo que no tienes que repetir la misma guía en cada conversación.

Beneficios clave:

• Especializa a Claude: Adapta las capacidades para tareas específicas de dominio
• Reduce la repetición: Crea una vez, usa automáticamente
• Compón capacidades: Combina Skills para tareas complejas de múltiples pasos



Uso de Skills

Anthropic proporciona Agent Skills preconstruidas para tareas comunes de documentos (PowerPoint, Excel, Word, PDF), y puedes crear tus propias Skills personalizadas. Ambas funcionan de la misma manera: una vez que una Skill está disponible en tu entorno, Claude la usa automáticamente cuando es relevante para tu solicitud.

Las Agent Skills preconstruidas están disponibles en claude.ai, la API de Claude, Claude Platform en 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 en AWS y Microsoft Foundry, sube Skills personalizadas a través de la Skills API.



Cómo funcionan las Skills

Las Skills usan el entorno de VM de Claude para proporcionar capacidades 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 habilita la divulgación progresiva: Claude carga información por etapas según sea necesario, en lugar de consumir contexto por adelantado.

Las Skills pueden contener tres tipos de contenido, cada uno cargado en un momento diferente:



Nivel 1: Metadatos (siempre cargados)

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 "system prompt" (indicación del sistema). La description es lo que Claude compara con tu solicitud al determinar si activar la Skill, por lo que debe decir tanto qué hace la Skill como cuándo usarla. Este enfoque ligero significa que puedes instalar muchas Skills sin penalización de contexto: hasta que una Skill se activa, solo su nombre y descripción ocupan contexto.



Nivel 2: Instrucciones (cargadas al activarse)

El cuerpo principal de SKILL.md contiene conocimiento procedimental: flujos de trabajo, mejores 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 usando bash. Solo entonces este contenido entra en la "context window" (ventana de contexto).



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

Las Skills pueden incluir materiales adicionales:

pdf-processing/
├── 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 y flujos de trabajo especializados

Código: Scripts ejecutables (fill_form.py, validate.py) que Claude ejecuta usando bash, proporcionando operaciones deterministas sin cargar su código en el 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 guía flexible, código para confiabilidad, recursos para búsqueda de datos.

La divulgación progresiva asegura que solo el contenido relevante ocupe la ventana de contexto en cualquier 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. 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 Claude accede al contenido de la Skill:

Cuando una Skill se activa, Claude usa bash para leer SKILL.md desde el sistema de archivos, trayendo 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 a través de bash y recibe solo la salida (el código del script en sí nunca entra en el contexto).

Lo que esta arquitectura habilita:

• Acceso a archivos bajo demanda: Claude lee solo los archivos que cada tarea necesita. Una Skill puede incluir docenas de archivos de referencia, pero si tu tarea solo necesita el esquema de ventas, ese es el único archivo que Claude carga. El resto permanece en el sistema de archivos y cuesta 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 su salida (como "Validation passed" o un mensaje de error específico) consume tokens, lo que 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: Los archivos no consumen contexto hasta que se accede a ellos, por lo que las Skills pueden incluir documentación completa de API, grandes conjuntos de datos o ejemplos extensos. No hay penalización de contexto por contenido incluido que no se usa.



Ejemplo: Carga de una Skill de procesamiento de PDF

Así es como Claude carga y usa la Skill personalizada pdf-processing de los ejemplos anteriores (no la Skill preconstruida pdf):

1. Inicio: La indicación del sistema incluye: pdf-processing - 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.
2. Solicitud del usuario: "Extrae el texto de este PDF y resúmelo"
3. Claude invoca: bash: cat pdf-processing/SKILL.md → Instrucciones cargadas en el contexto
4. Claude determina: No se necesita el llenado de formularios, por lo que FORMS.md no se lee
5. Claude ejecuta: Usa las instrucciones de SKILL.md para completar la tarea



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 preconstruidas 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 la herramienta de ejecución de código, en cuyo contenedor se ejecutan las Skills, y un encabezado beta:

• skills-2025-10-02 - Habilita la funcionalidad de Skills

Agrega un segundo encabezado, files-api-2025-04-14, cuando uses la Files API para subir archivos de entrada al contenedor o descargar archivos que una Skill produce.

Usa las Agent Skills preconstruidas haciendo referencia a su skill_id (pptx, xlsx, docx o pdf), 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 workspace: todos los miembros del workspace pueden acceder a ellas.

Las Skills en la API se ejecutan en un contenedor aislado (sandbox) sin acceso a la red y sin instalación de paquetes en tiempo de ejecución. Consulta Limitaciones y restricciones para más detalles.

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



Claude Code

Claude Code admite Skills personalizadas. Las Skills de documentos preconstruidas (PowerPoint, Excel, Word, PDF) no están disponibles en Claude Code, aunque la Skill de la API de Claude de código abierto viene incluida con él. Consulta la lista completa de comandos y Skills integrados que se incluyen con Claude Code.

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 subidas a la API: colócalas en ~/.claude/skills/ (personal) o .claude/skills/ (proyecto).

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



claude.ai

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

Agent Skills preconstruidas: Estas Skills están activas cuando creas documentos. Claude las usa sin necesidad de 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 administradas centralmente por los 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
• Enséñale 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 requeridos: 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

La description debe incluir tanto qué hace la Skill como cuándo Claude debe usarla. Para una guía completa de creación, consulta Mejores prácticas para la creación de Skills.



Consideraciones de seguridad

Usa Skills solo de fuentes confiables: aquellas que creaste tú mismo u obtuviste de Anthropic. Las Skills le dan a Claude nuevas capacidades a través de instrucciones y código, lo que 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 minuciosamente: 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átalo como instalar software: Ten especial cuidado al integrar Skills en sistemas de producción con acceso a datos sensibles u operaciones críticas

Para orientación sobre gobernanza, verificación e implementación a escala organizacional, consulta Skills para empresas.



Skills disponibles



Agent Skills preconstruidas

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

• PowerPoint (pptx): Crea presentaciones, edita diapositivas, analiza el contenido de presentaciones
• Excel (xlsx): Crea hojas de cálculo, analiza datos, genera informes con gráficos
• Word (docx): Crea documentos, edita contenido, da formato al texto
• PDF (pdf): Genera documentos e informes PDF con formato

Estas Skills están disponibles en la API de Claude, Claude Platform en AWS, Microsoft Foundry y claude.ai. 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:

• Skill de la API de Claude: Proporciona a Claude material de referencia de API actualizado, documentación de SDK y mejores prácticas para ocho 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 ejemplos completos de Skills personalizadas, consulta el Skills cookbook.



Retención de datos

Las Agent Skills no están cubiertas 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 la elegibilidad de ZDR en todas las funciones, consulta API y retención de datos.



Limitaciones y restricciones

Claude Platform en 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 automáticamente disponibles 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

Administra y sube 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 workspace. Todos los miembros del workspace pueden acceder a las Skills subidas.
• Claude Code: Personal (~/.claude/skills/) o basado en proyecto (.claude/skills/). También se pueden compartir a través de los Plugins de Claude Code.

claude.ai no admite la administración centralizada por administradores ni la distribución de Skills personalizadas en toda la organización.



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 la red variable: Dependiendo de la configuración del usuario/administrador, las Skills pueden tener acceso a la red completo, parcial o nulo. Para más detalles, consulta el artículo de soporte Crear y editar archivos.
• API de Claude:
  • Sin acceso a la red: Las 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.
• Claude Code:
  • Acceso completo a la red: Las Skills tienen el mismo acceso a la red que cualquier otro programa en la computadora del usuario.
  • Instalación global de paquetes desaconsejada: 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