ClawHub Skill Creator

Este skill proporciona instrucciones completas para crear y publicar skills en ClawHub con el formato correcto desde el primer intento.

🎯 Cuándo Usar Este Skill

Usa este skill cuando el usuario quiera:

• - Crear un skill nuevo para ClawHub
• Publicar un skill existente en ClawHub
• Corregir el formato de un skill mal estructurado
• Aprender la estructura correcta de un skill
• Entender el proceso de publicación paso a paso

📁 Estructura de Archivos Requerida

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

CODEBLOCK0

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:

CODEBLOCK2

Campos requeridos:

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

Ejemplo real:
CODEBLOCK3

Contenido del SKILL.md

Después del frontmatter, incluye:

CODEBLOCK4bash
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:

CODEBLOCK6

Campos requeridos:

• - name: Mismo nombre que en el YAML frontmatter
• INLINECODE5: Misma descripción que en el YAML frontmatter
• INLINECODE6: Versión semántica (recomendado: "1.0.0" para inicio)
• INLINECODE7: 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 Publicación Paso a Paso

Paso 1: Preparar el Skill

CODEBLOCK8

Paso 2: Verificar Formato

Antes de publicar, verifica:

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

Paso 3: Autenticar CLI de ClawHub

CODEBLOCK9

Nota: Debes tener una cuenta de GitHub con más de 14 días de antigüedad.

Paso 4: Publicar el Skill

CODEBLOCK10

Ejemplo real:
CODEBLOCK11

Paso 5: Verificar Publicación

Después de publicar, verás un mensaje como:

CODEBLOCK12

URL del skill:

https://clawhub.ai/{ID}/{slug}
Ejemplo: https://clawhub.ai/k97b6tvrydfc8ez4z02h8aamc9840cg2/lossless-claw-skill

⚠️ Errores Comunes y Soluciones

Error 1: "Path must be a folder"

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

Solución:
CODEBLOCK14

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

Causa: La CLI no está autenticada.

Solución:
CODEBLOCK15

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:
CODEBLOCK16

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:
CODEBLOCK18

_meta.json:
CODEBLOCK19

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

_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 Publicación

Antes de publicar, verifica:

• - [ ] Estructura de archivos

• - [ ] YAML Frontmatter

• - [ ] _meta.json

• - [ ] CLI Autenticada

• - [ ] Cuenta GitHub

🔗 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

1. 1. Mantén el frontmatter simple - Solo name y description son requeridos
2. Usa kebab-case - nombre-del-skill, no NombreDelSkill ni INLINECODE32
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 publicar
7. Documenta bien - Un SKILL.md claro ayuda a otros a usar tu skill