La respuesta corta
Una Skill es una carpeta con un archivo SKILL.md dentro. El archivo empieza con un encabezado breve que contiene un nombre y una descripción, y después vienen las instrucciones. Tu agente solo tiene presentes el nombre y la descripción hasta que una petición encaja; entonces lee el resto. La misma carpeta funciona en Claude Code, Codex y Cursor.
Por qué existen las Skills
Seguro que te ha pasado
Tienes un prompt de 40 líneas para landing pages de lanzamiento. Detalla el diseño, las secciones y las comprobaciones en ancho de móvil. Lo pegas cada vez, un día te saltas una línea y la página sale distinta. Luego un compañero te pide “ese prompt” y le mandas la copia del mes pasado.
Una Skill convierte ese prompt en una carpeta que tu agente encuentra solo. Por ejemplo, Meridian Marketing Landing: una vez instalada, el agente ya conoce el Hero con fondo de papel cuadriculado, la cuadrícula de funciones y el selector de precios. Tú solo aportas los datos de tu producto.
La mayoría de los ejemplos de Claude Skills siguen el mismo patrón: un método fijo para un tipo de resultado. Notion Style OG Image crea una imagen para compartir en 16:9, y otras Skills de Skillry crean presentaciones, sitios de currículum y videos cortos.
| Prompt pegado | Skill | |
|---|---|---|
| Qué explicas | Diseño, secciones, estilo y comprobaciones, cada vez | Solo tu contenido |
| De una ejecución a otra | Cambia un poco cada vez | Sigue los mismos pasos |
| Compartirlo | Rebuscar en tu historial de chat | Instalar la misma carpeta |
¿Qué hay dentro de un archivo SKILL.md?
Una Skill necesita un archivo, SKILL.md, y puede incluir carpetas opcionales con documentos de referencia, scripts y plantillas. El archivo tiene dos partes: un encabezado breve entre líneas --- y, después, instrucciones en texto normal escritas para el agente.
launch-page/
├── SKILL.md required
├── references/ optional: docs read when needed
├── scripts/ optional: code the agent can run
└── assets/ optional: templates and files---
name: launch-page
description: Build a product launch page with a hero, a feature
grid, and a pricing toggle. Use when asked for a launch page.
---
1. Ask for the product name, audience, and three features.
2. Build the hero, the feature grid, and the pricing section.
3. Check the page at phone width before you finish.name
Hasta 64 caracteres, con minúsculas, números y guiones. Debe coincidir con el nombre de la carpeta.
description
Hasta 1.024 caracteres. Di qué hace la Skill y cuándo usarla; el agente se basa en esa segunda parte para elegirla.
Opcionales
license, compatibility, metadata, allowed-tools
Estos límites vienen de la especificación abierta de Agent Skills. Claude Code es más flexible: puedes omitir name y usará el nombre de la carpeta.
¿Cómo decide un agente qué Skill usar?
Compara tu petición con la descripción de cada Skill. Para que eso salga barato, carga cada Skill en tres etapas:
- 1Al arrancar, lee el nombre y la descripción de cada Skill instalada. Nada más.
- 2Cuando tu petición encaja con una descripción, o llamas a la Skill por su nombre, carga el
SKILL.mdcompleto. - 3Mientras trabaja, abre archivos de
references/o ejecutascripts/solo cuando las instrucciones se lo indican.
Por eso puedes instalar decenas de Skills sin que tu agente vaya más lento. Hasta que una Skill hace falta, ocupa más o menos una frase de contexto.
| Agente | Llamar a una Skill por su nombre |
|---|---|
| Claude Code | /skill-name |
| Codex | $skill-name, o elígela en /skills |
| Cursor | /skill-name, o @skill-name para adjuntarla |
La elección automática solo es tan buena como la descripción. Activación explica cómo escribir una que se elija. Mientras tanto, llamar a la Skill por su nombre siempre funciona.
¿Qué agentes pueden usar Skills?
La mayoría de los agentes que conoces. Anthropic creó el formato para Claude y lo publicó como estándar abierto el 18 de diciembre de 2025. El sitio agentskills.io ya enumera decenas de herramientas que lo leen, entre ellas Claude Code, ChatGPT y Codex, Cursor, VS Code, GitHub Copilot y Gemini CLI.
| Agente | Carpeta personal |
|---|---|
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.agents/skills/ (también lee la antigua ~/.codex/skills/) |
| Cursor | ~/.cursor/skills/ o ~/.agents/skills/ |
Una Skill en tu carpeta personal está disponible en todos los proyectos de tu computadora. Las carpetas de proyecto y todos los demás sitios donde busca un agente están en Ubicaciones de las Skills.
¿Skill o prompt? Cuál deberías usar
Conviértelo en una Skill cuando vayas a repetir la tarea y quieras la misma calidad cada vez. Para algo puntual, basta con un prompt.
Lo volverás a hacer
- Necesita ejemplos, scripts o una lista de comprobación
- Quieres el mismo resultado cada vez
- Otras personas también lo necesitan
Es algo puntual
- Con unas pocas frases basta
- Todavía estás pensando qué quieres
- No hay nada que valga la pena reutilizar
Casi siempre usas los dos. El prompt dice lo que quieres hoy y la Skill dice cómo hacerlo bien. Skills vs prompts lo explica a fondo.
Qué revisar antes de instalar una Skill
Una Skill puede ejecutar scripts en tu computadora, así que dale una lectura rápida a cada una nueva antes de instalarla.
Una revisión de cinco minutos
- Lee
SKILL.mdy anota qué puede cambiar. - Lee todo lo que hay en
scripts/. Esos scripts se ejecutan en tu equipo. - Revisa Dependencias y Costos externos en la página de la Skill.
- No pongas contraseñas ni API keys en los archivos de la Skill ni en el chat.
La lista completa está en Seguridad. Cuando quieras probar una, Primeros pasos te acompaña en tu primera instalación.
Preguntas frecuentes
¿Qué son las Claude Skills?
Es como la mayoría de la gente llama a las Agent Skills cuando las usa en Claude o Claude Code. El formato es el mismo: una carpeta con un archivo SKILL.md. Esa misma carpeta también funciona en Codex y Cursor.
¿Cómo sabe Claude qué Skill usar?
Compara tu petición con la descripción de cada Skill y carga la que encaja. Si escribes /skill-name, te ahorras las conjeturas.
¿Puedo usar Claude Skills gratis?
Una Skill son solo archivos, así que una gratuita no cuesta nada. Aun así necesitas un agente compatible con Skills, como Claude Code, Codex o Cursor, con el plan que ese producto requiera. Skillry también tiene Skills gratuitas, como Dot Avatar Maker.
¿Una Skill es lo mismo que un servidor MCP?
No. Una Skill le enseña al agente un método, mientras que un servidor MCP lo conecta con datos y herramientas externas. A menudo se usan juntos. Consulta Skills vs MCP.
Fuentes
¿Te ha sido útil esta guía?