Skills

Crear Skills

Skills enseñan al agente cómo y cuándo usar herramientas. Cada skill es un directorio que contiene un archivo SKILL.md con frontmatter YAML e instrucciones en markdown.

Para saber cómo se cargan y priorizan las Skills, consulta Skills.

Crea tu primera skill

Crea el directorio de la skill

Las Skills viven en tu workspace. Crea una carpeta nueva:

mkdir -p ~/.openclaw/workspace/skills/hello-world

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.

---
name: hello-world
description: A simple skill that says hello.
---

# Hello World Skill

When the user asks for a greeting, use the `echo` tool to say
"Hello from your custom skill!".

Usa estilo con guiones y letras minúsculas, dígitos y guiones para el name de la skill. Mantén alineados el nombre de la carpeta y el name del frontmatter.

Añade herramientas (opcional)

Puedes definir esquemas de herramientas personalizados en el frontmatter o indicar al agente que use herramientas del sistema existentes (como exec o browser). Las Skills también pueden distribuirse dentro de plugins junto con las herramientas que documentan.

Carga la skill

Inicia una sesión nueva para que OpenClaw detecte la skill:

# From chat
/new

# Or restart the gateway
openclaw gateway restart

Verifica que la skill se haya cargado:

openclaw skills list

Pruébala

Envía un mensaje que debería activar la skill:

openclaw agent --message "give me a greeting"

O simplemente chatea con el agente y pídele un saludo.

Referencia de metadatos de skill

El frontmatter YAML admite estos campos:

Campo	Requerido	Descripción
`name`	Sí	Identificador único que usa letras minúsculas, dígitos y guiones
`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

Buenas prácticas

Sé conciso — indica al modelo qué 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	Prioridad	Alcance
`\<workspace\>/skills/`	Máxima	Por agente
`\<workspace\>/.agents/skills/`	Alta	Agente por workspace
`~/.agents/skills/`	Media	Perfil de agente compartido
`~/.openclaw/skills/`	Media	Compartido (todos los agentes)
Incluidas (distribuidas con OpenClaw)	Baja	Global
`skills.load.extraDirs`	Mínima	Carpetas compartidas personalizadas

Relacionado

Referencia de Skills — reglas de carga, prioridad y gating
Configuración de Skills — esquema de configuración skills.*
ClawHub — registro público de Skills
Construir Plugins — los plugins pueden distribuir Skills

# Crea tu primera skill