Creación de Skills
Las Skills enseñan al agente cómo y cuándo usar herramientas. Cada Skill es un directorio que contiene un archivoSKILL.md con frontmatter YAML e instrucciones en markdown.
Para saber cómo se cargan y priorizan las Skills, consulta Skills.
Crea tu primera Skill
Escribe SKILL.md
Crea
SKILL.md dentro de ese directorio. El frontmatter define los metadatos,
y el cuerpo en markdown contiene instrucciones para el agente.Añade herramientas (opcional)
Puedes definir esquemas de herramientas personalizadas en el frontmatter o indicar al agente
que use herramientas del sistema existentes (como
exec o browser). Las Skills también pueden
incluirse dentro de plugins junto con las herramientas que documentan.Carga la Skill
Inicia una nueva sesión para que OpenClaw detecte la Skill:Verifica que la Skill se haya cargado:
Referencia de metadatos de Skills
El frontmatter YAML admite estos campos:| Campo | Obligatorio | Descripción |
|---|---|---|
name | Sí | Identificador único (snake_case) |
description | Sí | Descripción de una línea que se muestra al agente |
metadata.openclaw.os | No | Filtro de SO (["darwin"], ["linux"], etc.) |
metadata.openclaw.requires.bins | No | Binarios requeridos en PATH |
metadata.openclaw.requires.config | No | Claves de configuración requeridas |
Prácticas recomendadas
- Sé conciso — indica al modelo qué debe hacer, no cómo ser una IA
- La seguridad primero — si tu Skill usa
exec, asegúrate de que los prompts no permitan inyección arbitraria de comandos desde entradas no confiables - Prueba localmente — usa
openclaw agent --message "..."para probar antes de compartir - Usa ClawHub — explora y contribuye Skills en ClawHub
Dónde viven las Skills
| Ubicación | Precedencia | Alcance |
|---|---|---|
\<workspace\>/skills/ | La más alta | Por agente |
\<workspace\>/.agents/skills/ | Alta | Por agente del workspace |
~/.agents/skills/ | Media | Perfil de agente compartido |
~/.openclaw/skills/ | Media | Compartido (todos los agentes) |
| Agrupadas (incluidas con OpenClaw) | Baja | Global |
skills.load.extraDirs | La más baja | Carpetas compartidas personalizadas |
Relacionado
- Referencia de Skills — reglas de carga, precedencia y restricción
- Configuración de Skills — esquema de configuración
skills.* - ClawHub — registro público de Skills
- Creación de plugins — los plugins pueden incluir Skills