Gestión de habilidades: descubrimiento, activación y prioridad
En esta página
Lección actualizada el 2 de noviembre de 2026 según la página Skills de la documentación de Vibe: se han añadido las ubicaciones
.agents/skills/, el orden oficial de descubrimiento (rutas personalizadas, proyecto, usuario) y el comando/reload. La documentación no define una regla de prioridad para dos habilidades con el mismo nombre; la versión anterior describía una. Fuente: Skills.
Cómo descubre Vibe las habilidades
Escribir una habilidad es una cosa; saber cuál se ejecuta realmente es otra. La documentación especifica el orden en que Vibe descubre las habilidades:
- Rutas personalizadas declaradas en
config.tomlmedianteskill_paths; - Habilidades de proyecto, ubicadas en
./.vibe/skills/o./.agents/skills/, que solo se cargan si la carpeta es de confianza; - Habilidades de usuario, ubicadas en
~/.vibe/skills/o~/.agents/skills/.
Las carpetas .agents/skills/ siguen la especificación abierta Agent Skills: una habilidad almacenada allí se comparte con otros agentes que adopten la misma especificación. Una sesión activa detecta las habilidades añadidas o modificadas; si un cambio no aparece, escribe /reload.
Estructura del directorio de habilidades
Las habilidades globales residen en tu directorio personal, cada una en su propia carpeta que contiene un archivo SKILL.md. Están disponibles en todas partes, en cualquier proyecto donde ejecutes Vibe.
~/.vibe/skills/
├── code-review/
│ └── SKILL.md
├── test-generator/
│ └── SKILL.md
└── doc-writer/
└── SKILL.md
Las habilidades locales, por el contrario, se versionan junto con el código del proyecto. Este es el lugar natural para una habilidad de despliegue o migración, que depende de la infraestructura exacta del repositorio y no tendría sentido en ningún otro sitio.
mon-projet/
├── .vibe/
│ └── skills/
│ ├── deploy-prod/
│ │ └── SKILL.md
│ └── db-migrate/
│ └── SKILL.md
├── src/
└── package.json
Por último, existen las rutas personalizadas, utilizadas para referenciar habilidades ubicadas en otro lugar de tu sistema. Las declaras en la configuración:
# ~/.vibe/config.toml
skill_paths = [
"/home/equipe/shared-skills",
"/opt/company-skills"
]
Este es el mecanismo preferido para compartir habilidades dentro de un equipo, ya sea mediante una carpeta de red o un repositorio Git clonado que todos actualicen en su entorno local.
Activación y desactivación de habilidades
De forma predeterminada, todas las habilidades descubiertas están activas. Dos ajustes simétricos te permiten recuperar el control. Con enabled_skills, cambias a una lista blanca: solo las habilidades listadas están activas; el resto se ignora.
# ~/.vibe/config.toml
enabled_skills = ["code-review", "test-generator"]
Con disabled_skills, te mantienes en una lista negra: todas las habilidades están activas excepto las que nombres. Esta es la opción correcta cuando una única habilidad te está estorbando temporalmente.
# ~/.vibe/config.toml
disabled_skills = ["experimental-feature"]
Patrones de filtrado
Ambos campos aceptan tres formas de entrada. La más sencilla es el nombre exacto, que funciona mientras la lista se mantenga corta:
enabled_skills = ["code-review", "test-generator", "doc-writer"]
Los patrones glob entran en juego una vez que tus nombres siguen una convención. El carácter * coincide con cualquier secuencia de caracteres, lo que te permite gestionar toda una familia en una sola línea:
# Activar todas las habilidades que empiezan por "test-"
enabled_skills = ["test-*"]
# Desactivar todas las habilidades experimentales
disabled_skills = ["experimental-*", "beta-*"]
Para casos que los glob no cubren —una alternativa, un patrón en medio de un nombre, un sufijo numérico—, antepón la expresión con re: para usar una expresión regular:
# Activar habilidades cuyo nombre contenga "review" o "audit"
enabled_skills = ["re:review|audit"]
# Desactivar habilidades versionadas (p. ej., "tool-v1", "tool-v2")
disabled_skills = ['re:.*-v\d+'] # cadena literal: la barra invertida no necesita escape
Dos habilidades con el mismo nombre
La documentación no describe una regla de prioridad para dos habilidades que tengan el mismo nombre en ubicaciones diferentes. Así que no cuentes con una “sobreescritura” implícita: asígnales nombres distintos (code-review-backend en lugar de un segundo code-review) y verifica qué se carga realmente. En el menú /, la descripción de cada habilidad comienza con su ámbito, project, user o vibe, lo cual es suficiente para detectar un duplicado. Una habilidad con el mismo nombre que un comando integrado no aparece en este menú.
Configuración a nivel de proyecto
Todos estos ajustes se combinan en un archivo .vibe/config.toml situado en la raíz del proyecto. El ejemplo siguiente muestra las tres palancas juntas: restringir la lista a las habilidades relevantes, excluir las que no lo son y añadir la carpeta compartida del equipo de backend.
# mon-projet/.vibe/config.toml
# Activar solo las habilidades relevantes para este proyecto
enabled_skills = ["test-generator", "deploy-prod", "db-migrate"]
# O desactivar las que no son relevantes
disabled_skills = ["doc-writer"]
# Añadir rutas adicionales
skill_paths = ["/home/equipe/backend-skills"]
Para verificar qué habilidades están disponibles realmente, abre el menú / en la sesión: cada habilidad aparece allí con su ámbito. Este es el primer reflejo cuando falta un comando de barra esperada, antes de probar /reload y comprobar el estado de confianza de la carpeta.
Puntos clave
- Vibe descubre habilidades en
~/.vibe/skills/,.vibe/skills/y enskill_pathspersonalizadas - Las habilidades locales tienen prioridad sobre las globales
- Usa
enabled_skillsodisabled_skillspara controlar la activación - Los patrones glob (
test-*) y las expresiones regulares (re:review|audit) simplifican el filtrado - Crea un
.vibe/config.tomlpor proyecto para personalizar el contexto - Comparte habilidades entre un equipo mediante
skill_pathsque apunten a una carpeta común