Skills
Las Skills son módulos de prompt reutilizables. Al cargar un SKILL.md, puedes añadir a la sesión instrucciones para un dominio concreto.
Resumen
- Reutiliza conocimiento de dominio como una skill
- Comparte el mismo comportamiento entre proyectos
- Activa/desactiva por sesión
En la versión Laravel se configura con skillDirectories y disabledSkills de SessionConfig.
Uso básico
skillDirectories son raíces explícitas para detectar skills.
Se pueden usar con independencia de la configuración de enableConfigDiscovery.
Al indicar un directorio padre, se detectan los SKILL.md de cada subdirectorio.
Solo sirve para la detección y no otorga al agente permisos generales de acceso a archivos.
También puedes indicarlo como array:
Deshabilitar skills
Con disabledSkills puedes deshabilitar solo algunas skills ya cargadas.
Estructura de directorios
En skillDirectories indica un directorio padre como skills/.
Las rutas relativas se resuelven una sola vez tomando como base el workingDirectory vigente en el momento de indicarlas.
- Omitido o
null: no cambia las demás fuentes de detección
[]: borra solo las raíces del SDK indicadas explícitamente
disabledSkills, la deshabilitación por fuente y los Managed Settings también se aplican a las skills detectadas desde raíces explícitas.
SKILL.md es Markdown y puede incluir opcionalmente frontmatter YAML.
Campos principales del frontmatter:
name: identificador de la skill (nombre que se indica en disabledSkills)
description: descripción breve de la skill
Si omites name, se usa el nombre del directorio.
Combinarlas con Custom Agents
Si indicas nombres de skill en customAgents[].skills, el contenido de esas skills se carga previamente al arrancar el agente correspondiente.
Si omites skills, no se inyecta contenido de skills en el agente.
También puedes descubrir y habilitar/deshabilitar skills vía RPC.
Buenas prácticas
- Divide las skills por dominio (
skills/security, skills/testing, etc.)
- Añade
name y description en el frontmatter
- Si hay instrucciones conflictivas, exclúyelas explícitamente con
disabledSkills
- Prueba primero de forma aislada y luego combina varias skills
Referencias
Última modificación el 19 de octubre de 2026