Escribe tu propio Skill: SKILL.md y publicación en ClawHub
Objetivo en una frase: completar con tus propias manos tu primer desarrollo de habilidades en OpenClaw: escribir desde cero una habilidad hello-world, recorrer toda la cadena «crear directorio → escribir SKILL.md → verificar la invocación» y aclarar qué hay que preparar antes de publicar en ClawHub.
Preparación
- Haber completado la lección anterior «Primeros pasos con Skills: instalación, uso y configuración» y saber usar habilidades ya hechas.
- Tener OpenClaw instalado en la máquina (Node 24.16.0+ o 26.1.0+), con el comando
openclawdisponible. - Basta con una ventana de terminal; no se necesitan dependencias adicionales.
Hazlo conmigo
Paso 1: crear el directorio de la habilidad
Las habilidades se colocan en la carpeta skills/ del espacio de trabajo; una habilidad es un directorio:
mkdir -p ~/.openclaw/workspace/skills/hello-worldSi quieres agruparlas, también puedes usar subcarpetas (por ejemplo skills/personal/hello-world); el nombre de la habilidad sigue determinado por el frontmatter de SKILL.md, y la invocación sigue siendo /hello-world.
Resultado esperado: el directorio skills/hello-world/ se crea correctamente; OpenClaw por defecto vigila el archivo SKILL.md bajo el directorio raíz de skills.
Paso 2: escribir SKILL.md
Crea un SKILL.md nuevo en el directorio: en el frontmatter escribe los metadatos y en el cuerpo las instrucciones para el agent.
---
name: hello-world
description: A simple skill that prints a greeting.
---
# Hello World
When the user asks for a greeting, use the `exec` tool to run:
```bash
echo "Hello from your custom skill!"
```Hay que respetar tres reglas de nomenclatura: name usa solo letras minúsculas, números y guiones; el nombre del directorio debe coincidir con el name del frontmatter; description se comprime en una sola línea y no supera los 160 caracteres: se muestra al agent y también aparece en el descubrimiento de comandos con barra.
Resultado esperado: el archivo se guarda como skills/hello-world/SKILL.md y el frontmatter se analiza correctamente.
Paso 3: verificar la carga y probar
openclaw skills listSi hello-world aparece en la lista, ya está cargada. Si continuaste una sesión antigua o el monitor estaba desactivado, refresca primero:
# 聊天里:归档当前会话,开新会话
/new# 或重启网关
openclaw gateway restartLuego prueba:
openclaw agent --message "give me a greeting"También puedes plantear tu necesidad directamente en el chat, o usar /skill hello-world para invocarla explícitamente por nombre.
Resultado esperado: el agent ejecuta los comandos de la habilidad y te responde con Hello from your custom skill!.
Verificación
Revisa punto por punto:
openclaw skills listpermite ver hello-world./skill hello-worldproduce salida al invocarse explícitamente.- Tras modificar SKILL.md,
/newo una nueva sesión tras reiniciar el gateway obtiene la lista de habilidades actualizada.
Si todo se cumple, tu primera habilidad ya está lista. Una habilidad es en esencia «directorio + SKILL.md»; una vez probada, puedes considerar publicarla en ClawHub para que otros la instalen: instala el CLI independiente de ClawHub (npm i -g clawhub), inicia sesión con clawhub login y publica con clawhub skill publish ~/.openclaw/workspace/skills/hello-world; los detalles como la revisión del registro se rigen por la documentación oficial de ClawHub.
Errores comunes
- El nombre del directorio no coincide con
name: el nombre de la habilidad es el del frontmatter, y el nombre del directorio es solo el contenedor; pero si no coinciden es fácil equivocarse al invocar, así que lo más cómodo es mantenerlos alineados. - description demasiado larga: superar los 160 caracteres afecta el descubrimiento de comandos con barra; comprímela en una sola línea.
- Cambios en SKILL.md sin efecto: las sesiones antiguas no actualizan automáticamente la lista de habilidades; prueba con
/newabriendo una sesión nueva o trasopenclaw gateway restart.
Próxima lección
Una vez que tu habilidad escrita a mano funciona, la próxima lección «Skill Workshop: deja que Claw aprenda habilidades por sí mismo» hace que Claw redacte, valide e itere habilidades por ti: así se cierra el círculo completo de «crear-validar-instalar-invocar» de OpenClaw 2.0.