功能描述

Create and publish ClawHub skills with the correct format. Includes YAML frontmatter template, _meta.json structure, and step-by-step publishing guide.

使用说明 (SKILL.md)

ClawHub Skill Creator

Name: ClawHub Skill Creator Guide
Author: yejay7

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:

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

```bash
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:

```json
{
  "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 Publicación Paso a Paso

Paso 1: Preparar el Skill

# 1. Crear directorio
mkdir -p /ruta/a/skills/nombre-del-skill

# 2. Crear SKILL.md con YAML frontmatter correcto
# 3. Crear _meta.json con estructura válida

Paso 2: Verificar Formato

Antes de publicar, 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 (puedes validar en jsonlint.com)

Paso 3: Autenticar CLI de ClawHub

# Ejecutar comando de login
npx clawhub login

# Se abrirá una URL en el browser:
# https://clawhub.ai/cli/auth?redirect_uri=...

# Navegar a esa URL en el browser
# El proceso CLI esperará el callback automáticamente

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

Paso 4: Publicar el Skill

npx clawhub publish /ruta/completa/al/skill \
  --slug nombre-del-skill \
  --name "Nombre Display del Skill" \
  --version 1.0.0 \
  --tags "tag1,tag2,tag3"

Ejemplo real:

npx clawhub publish /mnt/data/openclaw/workspace/.openclaw/workspace/skills/lossless-claw-skill \
  --slug lossless-claw-skill \
  --name "Lossless Claw Skill" \
  --version 1.0.0 \
  --tags "latest,lcm,memory,context"

Paso 5: Verificar Publicación

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

✔ OK. Published [email protected] (k97b6tvrydfc8ez4z02h8aamc9840cg2)

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:

# 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

```bash
curl wttr.in/Ciudad


**_meta.json:**
```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
- SKILL.md existe
- _meta.json existe
- Ambos están en la misma carpeta
YAML Frontmatter
- Comienza con ---
- Tiene campo name
- Tiene campo description
- Termina con ---
- No hay otros 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)
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)

🔗 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

Mantén el frontmatter simple - Solo name y description son requeridos
Usa kebab-case - nombre-del-skill, no NombreDelSkill ni nombre_del_skill
Descripciones claras - Máximo 160 caracteres, explica qué hace el skill
Tags relevantes - Usa 3-5 tags que describan la funcionalidad
Versiona correctamente - Empieza en 1.0.0, usa semver para updates
Prueba localmente - Verifica que el skill funcione antes de publicar
Documenta bien - Un SKILL.md claro ayuda a otros a usar tu skill

Creado con ❤️ para la comunidad OpenClaw

安全使用建议

This guide appears to do what it says: format and publish ClawHub skills. Before using it, note these practical points: (1) SKILL.md examples assume you have Node.js/npm (npx) and a browser available—those are required but not listed in the metadata; (2) 'npx clawhub login' will open a browser and perform an OAuth-style login tied to your GitHub account (the guide requires a GitHub account >14 days old); (3) 'npx' executes packages fetched from npm at run time—if you have any doubt about the 'clawhub' package, inspect its source (or install it from a trusted release) before running; (4) double-check absolute paths and that the SKILL.md/_meta.json content is correct before publishing since publishing is a networked action that will make the skill public; (5) treat publishing credentials and tokens carefully and publish only from a trusted machine and account. These are cautionary operational notes, not signs of malicious intent.

功能分析

Type: OpenClaw Skill Name: clawhub-skill-creator-guide Version: 1.0.0 This skill bundle is a legitimate instructional guide for creating and publishing skills on the ClawHub platform. It contains documentation and templates for SKILL.md and _meta.json, along with standard CLI usage instructions (e.g., npx clawhub login/publish) and troubleshooting tips. No malicious code, data exfiltration, or harmful prompt injection attempts were detected.

能力评估

ℹ Purpose & Capability

The name/description match the instructions: the document is a publishing/format guide for ClawHub skills. However, the SKILL.md shows commands that require Node/npm (npx) and a browser for OAuth callbacks, yet the registry metadata lists no required binaries—this omission is inconsistent but not malicious.

ℹ Instruction Scope

Instructions are scoped to skill creation and publishing (creating SKILL.md and _meta.json, verifying fields, running 'npx clawhub login' and 'npx clawhub publish'). These commands will perform network operations and open a browser for authentication; the guide uses absolute path examples (e.g., /mnt/data/...) but does not instruct reading unrelated system files or exfiltrating data.

✓ Install Mechanism

No install spec and no code files are present. Being instruction-only minimizes installation risk.

✓ Credentials

The skill requests no environment variables or credentials in metadata. The guide does require a GitHub account for CLI auth (not declared as an env var), which is appropriate for publishing.

✓ Persistence & Privilege

No 'always' privilege, no modifications to other skills, and autonomous invocation defaults are unchanged. The guide doesn't request persistent system privileges.

版本历史

v1.0.0

Initial release of ClawHub Skill Creator Guide. - Provides a complete, step-by-step guide for creating and publishing ClawHub skills in the correct format - Includes sample YAML frontmatter for SKILL.md and required _meta.json structure - Lists required and optional files for a valid skill - Details the full publishing workflow, CLI authentication, and validation checks - Troubleshoots common publishing errors - Features real-world examples and a comprehensive publication checklist

元数据

Slug clawhub-skill-creator-guide

版本 1.0.0

许可证 MIT-0

累计安装 0

当前安装数 0

历史版本数 1

常见问题