Los skills son la forma más fácil de enseñarle a un agente de programación algo que no hace bien de serie: un estándar de diseño, una lista de revisión, una manera de ahorrar tokens. Esta guía explica dónde viven los skills de Claude Code y Codex, cómo instalarlos a mano y cómo gestionarlos sin la línea de comandos.
¿Qué es un skill?
Un skill es una carpeta con un archivo SKILL.md: instrucciones en Markdown con un nombre y una descripción cortos al principio, más los scripts o archivos de referencia que necesite. El agente lee las descripciones de los skills instalados y solo carga las instrucciones completas de un skill cuando la tarea lo pide, así que apenas consumen contexto hasta que se usan.
my-skill/
├── SKILL.md
└── scripts/
└── check.sh
Dónde buscan los skills Claude Code y Codex
| Agente | Skills personales (todos los proyectos) | Skills del proyecto |
|---|---|---|
| Claude Code | ~/.claude/skills/<name>/ |
.claude/skills/<name>/ en el repositorio |
| Codex | ~/.codex/skills/<name>/ o ~/.agents/skills/<name>/ |
según la documentación de Codex |
Si defines CLAUDE_CONFIG_DIR o CODEX_HOME, las carpetas personales se mueven con ellas.
Cómo instalar un skill a mano
- Busca el repositorio del skill y la carpeta que contiene su
SKILL.md. - Copia esa carpeta en tu directorio de skills:
git clone https://github.com/owner/repo /tmp/repo
cp -R /tmp/repo/skills/my-skill ~/.claude/skills/- Abre una sesión nueva del agente para que cargue el skill.
Actualizar significa repetir la copia, y no hay forma de deshacerlo si la versión nueva da problemas, así que guarda una copia de seguridad de la carpeta antigua.
Instala solo skills de confianza. Un skill puede incluir scripts que el agente puede ejecutar con tus permisos. Lee antes el SKILL.md y los scripts.
Gestiona tus propios repositorios de skills con Vibe Console
En el panel Skills de Vibe Console, añade un repositorio de GitHub de confianza como owner/repo o https://github.com/owner/repo. Elige una sección para su tarjeta y después qué skills instalar para Claude Code o Codex. La lista se guarda en tu Mac; Vibe Console no proporciona los archivos de los skills. Puedes quitar cualquier tarjeta de la lista sin desinstalar lo que ya instalaste.
Actualizaciones seguras con vuelta atrás
Vibe Console comprueba si hay actualizaciones de los skills instalados y los marca como Actualización disponible, o como El origen es distinto — revisa los cambios cuando los archivos del disco ya no coinciden con el origen. Al actualizar se guarda una copia de seguridad de los archivos anteriores. Si la versión nueva da problemas, pulsa Revertir, o Abrir copia de seguridad para revisar los archivos antiguos.
Preguntas frecuentes
¿Los skills funcionan en Claude Code y en Codex?
El formato SKILL.md funciona en los dos, pero cada agente carga los skills desde su propia carpeta. Instala el skill para cada agente que uses.
¿Los skills instalados ralentizan al agente?
Casi nada. Los agentes solo leen la descripción corta de cada skill hasta que una tarea lo necesita.
¿Cómo elimino un skill?
Borra su carpeta del directorio de skills y abre una sesión nueva.
Prueba el panel Skills gratis durante 14 días: descarga Vibe Console.