Los agent skills son carpetas con instrucciones, scripts y recursos que un agente de IA carga solo cuando la tarea los necesita. Sirven para que la IA haga un trabajo repetido siempre con el mismo proceso, el mismo formato y las mismas reglas, sin que tengas que explicárselo en cada conversación.
Anthropic los presentó para Claude el 16 de octubre de 2025. Para un jefe de área, la idea cabe en una frase: un skill es el manual de procedimiento que le darías a una persona nueva, pero escrito para la IA.
Qué es un skill, explicado sin tecnicismos
Un skill es una carpeta. Adentro hay un archivo principal, SKILL.md, con las instrucciones de una tarea, y a veces otros archivos de apoyo: una plantilla, un ejemplo, un pequeño programa. Anthropic lo define así en su anuncio: «carpetas que incluyen instrucciones, scripts y recursos que Claude puede cargar cuando los necesita».
La diferencia con todo lo que ya conocías está en la segunda parte de esa frase. La IA no lee el skill todo el tiempo: lo abre solo cuando es relevante para la tarea. Si le pides un resumen de una reunión, no abre el skill de propuestas comerciales.
Qué hay dentro de la carpeta
- Un nombre, corto y en minúsculas con guiones (por ejemplo,
propuesta-comercial). Máximo 64 caracteres, y no puede contener las palabras «claude» ni «anthropic». - Una descripción de qué hace y cuándo usarlo, de máximo 1.024 caracteres. Es la parte más importante: con ella la IA decide si lo abre.
- Las instrucciones: los pasos, el formato de salida, las reglas y lo que no se debe hacer.
- Recursos opcionales: plantillas, ejemplos, listas de precios vigentes o scripts que la IA ejecuta cuando hace falta.
Cómo sabe la IA cuándo usarlo: la divulgación progresiva
El skill se lee por capas, de lo más corto a lo más largo. Los ingenieros de Anthropic llaman a esto divulgación progresiva y dicen que es «el principio de diseño central» de los skills. Funciona como el índice de un manual: primero miras el índice, después abres el capítulo que te sirve y solo si hace falta vas al anexo.
| Capa | Qué carga la IA | Cuándo |
|---|---|---|
| 1. La etiqueta | Solo el nombre y la descripción (unos 100 tokens por skill; un token es un pedazo de palabra) | Siempre, al empezar |
| 2. El capítulo | Las instrucciones completas del SKILL.md (menos de 5.000 tokens) | Cuando la tarea coincide con la descripción |
| 3. Los anexos | Plantillas, ejemplos y scripts | Solo si la tarea los pide. De los scripts entra el resultado, no el código |
La consecuencia práctica, según la documentación de Claude: puedes instalar muchos skills sin llenarle la memoria de trabajo a la IA, porque de cada uno solo ve la etiqueta hasta que lo necesita. Esa memoria de trabajo tiene nombre, ventana de contexto, y está explicada en el glosario de IA.
En corto: un prompt se lo repites a la IA cada vez. Un skill se lo escribes una vez y ella lo abre cuando toca.
Skills de Claude: dónde funcionan y en qué planes
En Claude los skills funcionan en las apps, en Claude Code y en la API, pero cada superficie guarda los suyos. Esto, a 28 de octubre de 2026:
- Apps de Claude (claude.ai). Traen skills prediseñados para PowerPoint, Excel, Word y PDF, y puedes subir los tuyos en un archivo zip desde Configuración > Funciones. Requieren tener activada la ejecución de código.
- Claude Code. Los skills son carpetas en tu computador:
~/.claude/skills/para los personales o.claude/skills/dentro de un proyecto, y también llegan dentro de plugins. Los prediseñados de documentos no están aquí. Si no conoces la herramienta, empieza por qué es Claude Code. - API de Claude y Agent SDK. Para quien construye agentes propios. En la API, los skills corren sin acceso a internet.
Sobre los planes: según el centro de ayuda de Claude, a septiembre de 2026, los skills están disponibles en los planes Free, Pro, Max, Team y Enterprise, con la ejecución de código activada. En Team y Enterprise, los propietarios de la organización pueden habilitar skills para todos los usuarios.
Un detalle que importa en una empresa: los skills no se sincronizan. El que subes a claude.ai no aparece en la API, y los de Claude Code son archivos aparte. Si el área usa varias superficies, alguien tiene que ser dueño de la versión oficial.
Agent skills vs MCP: en qué se diferencian
El MCP conecta la IA con tus datos; el skill le enseña qué hacer con ellos. Anthropic lo dice en una línea en Skills explained: «MCP conecta a Claude con los datos; los skills le enseñan a Claude qué hacer con esos datos».
Un ejemplo de ventas. El MCP le da a Claude acceso a tu CRM: puede leer las oportunidades abiertas. El skill le dice cómo arma tu equipo el informe semanal: qué columnas, qué se considera una oportunidad en riesgo, en qué orden se presentan y qué tono usar con la gerencia. Sin el MCP no tiene los datos. Sin el skill tiene los datos, pero hace el informe a su manera.
No compiten: se combinan.
Skill, prompt, Project, subagente y CLAUDE.md: cuál usar
Todos le dan instrucciones a la IA. Cambia cuándo se cargan y para qué sirven.
| Pieza | Qué es | Cuándo se carga | Úsala para |
|---|---|---|---|
| Prompt | La instrucción que escribes en una conversación | Solo en esa conversación | Una tarea de una vez |
| Project | Conocimiento de fondo: documentos y contexto | Siempre, dentro del proyecto | «Lo que necesitas saber» |
| CLAUDE.md o instrucciones personalizadas | Reglas generales | En cada sesión o conversación | «Siempre haz X» |
| Skill | Un procedimiento empaquetado | Solo cuando la tarea lo pide | «Así se hace esta tarea» |
| MCP | Una conexión con datos o apps externas | Cuando hay que usar esa herramienta | Traer datos o actuar en otra app |
| Subagente | Un trabajador aparte, con su propia memoria de trabajo | Cuando se le delega algo | Tareas largas que devuelven solo un resumen |
| Hook | Una regla automática que se dispara en un evento | Siempre, sin que la IA decida | Barandas que no pueden fallar |
Tres reglas para decidir, sacadas de la documentación oficial:
- Si repites el mismo prompt, conviértelo en skill. El prompt no pasa a la siguiente conversación; el skill, sí.
- Lo que debe pasar siempre va en un hook. El skill lo interpreta la IA y el resultado puede variar.
- Skill y subagente se combinan. Un subagente puede trabajar con skills cargados.
Skills, MCP, hooks y subagentes son piezas del entorno que rodea al modelo. Diseñar ese entorno tiene nombre: harness engineering.
¿Tu equipo ya paga Claude y cada quien lo usa a su manera?
Entrenamos al área sobre su trabajo real: Projects por área y skills con sus propias plantillas y procesos, para que las tareas que se repiten sigan el mismo proceso cada vez.
Agent skills, un estándar abierto: quién más los usa
Anthropic publicó Agent Skills como estándar abierto el 18 de diciembre de 2025. Hoy lo soportan, según su propia documentación, GitHub Copilot y VS Code, Codex y ChatGPT de OpenAI, Cursor y Gemini CLI de Google. Un skill bien escrito no te amarra a una sola herramienta.
El estándar vive en agentskills.io, que lo describe como «un formato liviano y abierto para ampliar las capacidades de los agentes de IA», desarrollado originalmente por Anthropic. Lo que confirmamos en la documentación de cada empresa:
- GitHub Copilot y VS Code, desde el 18 de diciembre de 2025: en el agente de Copilot, en Copilot CLI y en el modo agente de VS Code (primero en la versión Insiders y a inicios de enero en la estable). La documentación de VS Code lo llama «un estándar abierto». La nota de lanzamiento dice que, si ya tienes skills de Claude Code en la carpeta
.claude/skillsdel repositorio, Copilot los toma solo. - OpenAI, Codex y ChatGPT: Codex lee skills desde diciembre de 2025, cuando llegaron como función experimental. Según la documentación de OpenAI, sus skills se basan en el estándar abierto y funcionan en la app de escritorio de ChatGPT, en Codex CLI y en la extensión para editores de código.
- Cursor, desde la versión 2.4 del 22 de enero de 2026, en el editor y en la terminal. Lee también las carpetas de skills de Claude y de Codex.
- Gemini CLI, de Google: su documentación dice que sus skills están basados en el estándar abierto de Agent Skills.
Para qué le sirven los agent skills a una empresa
Los skills son la forma de empaquetar «cómo hacemos las cosas aquí» para que la IA lo aplique igual cada vez, la use quien la use. El área deja de depender de que cada persona escriba un buen prompt.
Tres candidatos que existen en casi cualquier área:
- El manual del área. Cómo se responde una queja, cómo se clasifica una solicitud, qué se escala y a quién.
- La plantilla de propuesta. La estructura, el tono, lo que nunca se promete y de dónde salen los precios.
- El checklist de revisión. Lo que se revisa antes de que un contrato, una pieza de marketing o un informe salga de la empresa.
La pista para encontrar el primero: busca la explicación que tu equipo repite en cada conversación con la IA. Ese texto ya es un skill a medio escribir. Así se ve uno sencillo:
--- name: propuesta-comercial description: Arma propuestas comerciales con la estructura y el tono de la empresa. Úsalo cuando pidan una propuesta, una cotización formal o la respuesta a la solicitud de un cliente. --- # Propuesta comercial ## Antes de escribir 1. Pide lo que falte: cliente, problema, alcance y fechas. 2. Lee plantilla.md (estructura) y precios.md (tarifas vigentes). ## Estructura - El problema del cliente, con sus palabras. - Qué proponemos, en tres a cinco puntos. - Qué no incluye. - Próximo paso, con fecha. ## Reglas - No inventes precios: usa solo los de precios.md. - Tuteo, frases cortas, sin adjetivos vacíos. - Marca con [REVISAR] lo que no esté claro. - Una persona aprueba la propuesta antes de enviarla.
La carpeta llevaría ese archivo, más plantilla.md y precios.md. Si cambian las tarifas, se actualiza un archivo y todo el equipo queda al día.
Cómo usamos skills y subagentes en PorContar
Usamos esto en nuestro propio trabajo, empezando por este blog. Este artículo no lo escribió un solo prompt:
- Un CLAUDE.md con las reglas de la web: la marca, los colores, qué páginas existen y qué no se toca. Se carga en cada sesión.
- Subagentes con un oficio cada uno: uno investiga palabras clave, otro verifica cada dato en la fuente oficial y lo deja anotado con fecha, otro redacta solo con esos datos y otro revisa la pieza contra nuestra guía antes de publicarla.
- Un hook que no negocia: bloquea cualquier imagen que no esté en la lista de fotos verificadas. Esa regla no puede depender de que la IA se acuerde.
- Skills para tareas que se repiten, como guiones para redes, actas de reunión, cotizaciones y artículos de blog. Cada uno deja escrita la estructura y el tono que queremos. No reemplaza la revisión de una persona.
Lo que aprendimos montándolo: un skill vale lo que vale su descripción. Si la descripción es vaga, la IA no sabe cuándo abrirlo. Y lo que no puede fallar nunca va en un hook, no en un skill.
Qué revisar antes de instalar un skill
Un skill puede traer código que la IA ejecuta, así que se instala con el mismo cuidado que un programa. La documentación de Claude es directa: usa solo skills de fuentes de confianza, los que creaste tú o los que vienen de Anthropic.
- Revisa todos los archivos, no solo el SKILL.md. Un skill malicioso puede sacar información o abrir accesos que nadie autorizó.
- Mira a qué llega. En Claude Code, un skill tiene el mismo acceso a la red que cualquier programa del computador.
- Si tu empresa tiene un acuerdo de retención cero de datos, ten en cuenta que los skills no están cubiertos por esos acuerdos.
- Nombra un dueño por skill. Alguien del área responde por su contenido y lo actualiza cuando cambia el proceso.
Por dónde empezar con tu equipo
No empieces por la herramienta. Empieza por la tarea que el área repite cada semana y que hoy sale distinta según quién la haga. Escribe cómo se hace bien, conviértela en un skill, pruébala con tres casos reales y ajusta la descripción hasta que la IA la abra cuando toca.
Eso es lo que practicamos en la capacitación en Claude para empresas, una de las rutas de nuestra capacitación corporativa en IA: el equipo arma sus primeros skills sobre sus propios documentos y procesos. Si quieres entender primero la herramienta completa, lee qué es Claude IA y para qué sirve.
¿Qué tareas de tu equipo ya están listas para un skill?
Responde el diagnóstico en dos minutos: te muestra en qué nivel de adopción de IA está tu equipo y por dónde conviene empezar. Si quieres, lo revisamos juntas en 30 minutos.
Preguntas frecuentes
¿Qué son los agent skills?
¿Qué diferencia hay entre agent skills y MCP?
¿Los skills de Claude funcionan en el plan gratuito?
¿Necesito saber programar para crear un skill?
¿Los agent skills solo funcionan con Claude?
¿Es seguro instalar skills hechos por otros?
¿En qué se diferencia un skill de un Proyecto de Claude?
¿Cómo se instala un skill en Claude?
Fuentes: Anthropic, "Introducing Agent Skills" y "Equipping agents for the real world with Agent Skills" (16 oct 2025, actualizados el 18 dic 2025) y "Skills explained" (5 mar 2026) · Documentación de Claude (platform.claude.com y code.claude.com) · Centro de ayuda de Claude, "What are skills?" (22 sep 2026) · agentskills.io · GitHub Changelog (18 dic 2025) · Documentación de VS Code, OpenAI, Cursor (changelog 2.4, 22 ene 2026) y Gemini CLI · Verificado el 28 de octubre de 2026
