← 返回
未分类 中文

OpenClaw Skill Creator

Crea skills para OpenClaw con el formato correcto. YAML frontmatter, _meta.json, estructura de archivos. Publicar en ClawHub es opcional.
使用正确的格式为 OpenClaw 创建技能。YAML frontmatter、_meta.json、文件结构。可选择在 ClawHub 上发布。
yejay7 yejay7 来源
未分类 clawhub v1.0.0 1 版本 100000 Key: 无需
★ 1
Stars
📥 352
下载
💾 0
安装
1
版本
#latest#local#openclaw#skill-creator#template

概述

OpenClaw Skill Creator

Este skill proporciona instrucciones completas para crear skills en OpenClaw con el formato correcto desde el primer intento. Los skills se guardan localmente en tu workspace.

Publicar en ClawHub es opcional.


🎯 Cuándo Usar Este Skill

Usa este skill cuando el usuario quiera:

  • Crear un skill nuevo para OpenClaw (función principal)
  • Guardar un skill en el panel local de skills
  • Corregir el formato de un skill mal estructurado
  • Aprender la estructura correcta de un skill
  • Publicar un skill en ClawHub (opcional)

📁 Estructura de Archivos Requerida

Un skill de ClawHub debe tener esta estructura mínima:

nombre-del-skill/
├── SKILL.md          # Obligatorio - Documentación del skill
└── _meta.json        # Obligatorio - Metadatos del skill

Archivos opcionales:

nombre-del-skill/
├── README.md         # Documentación adicional
├── scripts/          # Scripts ejecutables
├── references/       # Referencias y ejemplos
└── assets/           # Recursos adicionales

📝 Formato Correcto de SKILL.md

YAML Frontmatter (OBLIGATORIO)

El archivo SKILL.md DEBE comenzar con YAML frontmatter en este formato exacto:

---
name: nombre-del-skill
description: Descripción clara y concisa del skill (máx 160 caracteres)
---

Campos requeridos:

  • name: Nombre del skill (kebab-case, sin espacios, minúsculas)
  • description: Descripción breve (aparece en ClawHub search)

Ejemplo real:

---
name: lossless-claw-skill
description: Wrapper seguro para el plugin lossless-claw (LCM). Proporciona interfaz para lcm_grep, lcm_describe, lcm_expand_query.
---

Contenido del SKILL.md

Después del frontmatter, incluye:

# Nombre del Skill

Descripción extendida del propósito del skill.

---

## Descripción

Explicación detallada de qué hace el skill y por qué es útil.

## Cuándo Usar Este Skill

Lista de casos de uso específicos:

- Cuando el usuario necesita X
- Cuando ocurre Y
- Para resolver Z

## Cómo Usar

Instrucciones paso a paso o ejemplos de comandos.

## Ejemplos

npx clawhub install nombre-del-skill


## Notas Adicionales

Información extra, advertencias, o referencias.

📋 Formato de _meta.json

El archivo _meta.json debe tener esta estructura:

{
  "name": "nombre-del-skill",
  "description": "Descripción clara y concisa del skill",
  "version": "1.0.0",
  "tags": ["categoria", "utilidad", "feature"]
}

Campos requeridos:

  • name: Mismo nombre que en el YAML frontmatter
  • description: Misma descripción que en el YAML frontmatter
  • version: Versión semántica (recomendado: "1.0.0" para inicio)
  • tags: Array de tags para búsqueda (mínimo 1, máximo 5)

Ejemplo real:

{
  "name": "lossless-claw-skill",
  "description": "Wrapper seguro para el plugin lossless-claw (LCM). Proporciona interfaz para lcm_grep, lcm_describe, lcm_expand_query.",
  "version": "1.0.0",
  "tags": ["latest", "lcm", "memory", "context"]
}

🚀 Proceso de Creación de Skills (LOCAL)

Paso 1: Crear el Skill

El skill se creará automáticamente en:

/mnt/data/openclaw/workspace/.openclaw/workspace/skills/nombre-del-skill/

Estructura:

nombre-del-skill/
├── SKILL.md       # Con YAML frontmatter correcto
└── _meta.json     # Metadatos del skill

Paso 2: Verificar Formato

Antes de usar el skill, verifica:

  • [ ] SKILL.md tiene YAML frontmatter (--- al inicio y fin)
  • [ ] name en YAML coincide con name en _meta.json
  • [ ] description en YAML coincide con description en _meta.json
  • [ ] El nombre usa kebab-case (guiones, sin espacios)
  • [ ] _meta.json es JSON válido

Paso 3: Reiniciar Gateway (si es necesario)

Para que OpenClaw cargue el nuevo skill:

openclaw gateway restart

O usa el comando desde OpenClaw:

/gateway restart

Paso 4: ¡Listo! El skill está disponible

El skill ahora está en tu panel local y puede ser usado por tu agente.


🌐 Publicar en ClawHub (OPCIONAL)

Si quieres compartir tu skill con la comunidad:

Paso A: Autenticar CLI de ClawHub

npx clawhub login
# Navegar a la URL que aparece en el output

Nota: Cuenta de GitHub debe tener más de 14 días de antigüedad.

Paso B: Publicar

npx clawhub publish /mnt/data/openclaw/workspace/.openclaw/workspace/skills/nombre-del-skill \
  --slug nombre-del-skill \
  --name "Nombre del Skill" \
  --version 1.0.0 \
  --tags "tag1,tag2,tag3"

Paso C: Verificar

✔ OK. Published nombre-del-skill@1.0.0 (ID)
URL: https://clawhub.ai/{ID}/{slug}

⚠️ Errores Comunes y Soluciones

Error 1: "Path must be a folder"

Causa: La ruta no es absoluta o la carpeta no existe.

Solución:

# Usar ruta absoluta completa
npx clawhub publish /mnt/data/openclaw/workspace/.openclaw/workspace/skills/nombre-del-skill

Error 2: "Not logged in. Run: clawhub login"

Causa: La CLI no está autenticada.

Solución:

npx clawhub login
# Navegar a la URL que aparece en el output

Error 3: "GitHub API rate limit exceeded"

Causa: Límite temporal de API de GitHub.

Solución: Esperar 30-60 segundos y reintentar.

Error 4: "GitHub account must be at least 14 days old"

Causa: La cuenta de GitHub fue creada recientemente.

Solución: Usar una cuenta de GitHub con más de 14 días de antigüedad.

Error 5: Skill no aparece en ClawHub panel después de instalar

Causa: Formato incorrecto de YAML frontmatter.

Solución: Verificar que el frontmatter sea exactamente:

---
name: nombre-del-skill
description: Descripción del skill
---

NO usar este formato incorrecto:

# ❌ INCORRECTO - Muy complejo
name: skill-name
description: ...
author: ...
version: ...

📚 Ejemplos de Skills Reales

Ejemplo 1: Skill Simple (Wrapper)

SKILL.md:

---
name: lossless-claw-skill
description: Wrapper seguro para el plugin lossless-claw (LCM).
---

# Lossless Claw Skill

Skill wrapper para el plugin lossless-claw de OpenClaw.

## Descripción

Proporciona una interfaz segura para las herramientas LCM.

## Cuándo Usar

- Cuando necesitas buscar en el historial de conversación
- Cuando necesitas expandir resúmenes compactados
- Para queries complejas de memoria

_meta.json:

{
  "name": "lossless-claw-skill",
  "description": "Wrapper seguro para el plugin lossless-claw (LCM).",
  "version": "1.0.0",
  "tags": ["latest", "lcm", "memory"]
}

Ejemplo 2: Skill con Scripts

SKILL.md:

---
name: weather-skill
description: Obtén el clima actual y pronósticos vía wttr.in o Open-Meteo.
---

# Weather Skill

Obtén información meteorológica para cualquier ubicación.

## Cuándo Usar

- Cuando el usuario pregunta sobre el clima
- Para pronósticos de 1-7 días
- Para temperaturas actuales

## Comandos

curl wttr.in/Ciudad

_meta.json:

{
  "name": "weather-skill",
  "description": "Obtén el clima actual y pronósticos vía wttr.in o Open-Meteo.",
  "version": "1.0.0",
  "tags": ["weather", "forecast", "utility"]
}

🎓 Checklist de Creación de Skill (LOCAL)

Antes de usar el skill, verifica:

  • [ ] Estructura de archivos
  • [ ] SKILL.md existe
  • [ ] _meta.json existe
  • [ ] Ambos están en la misma carpeta: skills/nombre-del-skill/
  • [ ] YAML Frontmatter
  • [ ] Comienza con ---
  • [ ] Tiene campo name
  • [ ] Tiene campo description
  • [ ] Termina con ---
  • [ ] No hay campos innecesarios
  • [ ] _meta.json
  • [ ] Es JSON válido
  • [ ] Tiene campo name (mismo que YAML)
  • [ ] Tiene campo description (mismo que YAML)
  • [ ] Tiene campo version
  • [ ] Tiene campo tags (array)
  • [ ] Gateway Reiniciado (si OpenClaw no detecta el skill)
  • [ ] openclaw gateway restart ejecutado
  • [ ] Skill aparece en el panel después del restart

🌐 Checklist Adicional para Publicar en ClawHub (OPCIONAL)

Solo si quieres publicar en ClawHub:

  • [ ] CLI Autenticada
  • [ ] npx clawhub login ejecutado
  • [ ] URL de auth navegada en browser
  • [ ] Mensaje "OK. Logged in as @usuario" apareció
  • [ ] Cuenta GitHub
  • [ ] Cuenta tiene más de 14 días de antigüedad
  • [ ] No hay rate limit activo (esperar 60s si hay error)
  • [ ] Slug Disponible
  • [ ] El slug no está tomado por otro skill
  • [ ] Si está tomado, usa una variación única

🔗 Recursos Adicionales

  • ClawHub: https://clawhub.ai
  • Documentación OpenClaw: https://docs.openclaw.ai
  • Skills existentes: https://clawhub.ai/skills
  • GitHub: https://github.com/openclaw/openclaw

💡 Consejos Profesionales

Para Creación Local:

  1. Mantén el frontmatter simple - Solo name y description son requeridos
  2. Usa kebab-case - nombre-del-skill, no NombreDelSkill ni nombre_del_skill
  3. Descripciones claras - Máximo 160 caracteres, explica qué hace el skill
  4. Tags relevantes - Usa 3-5 tags que describan la funcionalidad
  5. Versiona correctamente - Empieza en 1.0.0, usa semver para updates
  6. Prueba localmente - Verifica que el skill funcione antes de usarlo
  7. Documenta bien - Un SKILL.md claro ayuda a tu agente a usar el skill
  8. Reinicia el gateway - Después de crear un skill, reinicia para que OpenClaw lo detecte

Para Publicación en ClawHub (Opcional):

  1. Verifica slug disponible - Busca en ClawHub antes de publicar
  2. Cuenta con 14+ días - GitHub requiere antigüedad mínima
  3. Espera rate limits - Si hay error, espera 60s y reintenta

📌 Nota Importante

Este skill está diseñado para:

  1. Crear skills localmente (función principal)
  2. Guardar en tu panel de skills de OpenClaw
  3. Publicar en ClawHub (opcional, para compartir con la comunidad)

No necesitas publicar en ClawHub para que tu skill funcione. Los skills locales son completamente funcionales y tu agente puede usarlos inmediatamente después de crearlos y reiniciar el gateway.


Creado con ❤️ para la comunidad OpenClaw

版本历史

共 1 个版本

  • v1.0.0 当前
    2026-05-07 10:14 安全 安全

安全检测

腾讯云安全 (Keen)

安全,无风险
查看报告

腾讯云安全 (Sanbu)

安全,无风险
查看报告

🔗 相关推荐

dev-programming

Mcporter

steipete
使用 mcporter CLI 直接列出、配置、认证及调用 MCP 服务器/工具(支持 HTTP 或 stdio),涵盖临时服务器、配置编辑及 CLI/类型生成功能。
★ 197 📥 68,073
dev-programming

Github

steipete
使用 `gh` CLI 与 GitHub 交互,通过 `gh issue`、`gh pr`、`gh run` 和 `gh api` 管理议题、PR、CI 运行及高级查询。
★ 682 📥 330,142
dev-programming

CodeConductor.ai

larsonreever
AI驱动平台,提供快速全栈开发、智能体、工作流自动化及低代码AI集成的可扩展产品创建。
★ 79 📥 182,696