Cómo crear y revisar Skills de OpenClaw

Lo que vas a construir

Un flujo de trabajo de desarrollo y revisión de skills que te permite:

1. Crear skills personalizados — desarrollar nuevos skills de OpenClaw adaptados a tus necesidades específicas
2. Revisar skills de la comunidad — evaluar skills de ClawHub en calidad, seguridad y fiabilidad
3. Descomponer tareas complejas — dividir flujos de trabajo multietapa en cadenas de skills reutilizables
4. Iterar y mejorar — probar, depurar y refinar skills con feedback asistido por IA

Al terminar esta guía, podrás crear skills de calidad para producción y evaluar con confianza cualquier skill antes de instalarlo.

Por qué crear skills personalizados

ClawHub tiene cientos de skills de la comunidad, pero a veces necesitas algo específico:

• Herramientas internas — las APIs, dashboards y flujos de trabajo de tu empresa no están cubiertos por skills públicos
• Integraciones a medida — usas herramientas de nicho o sistemas propietarios que necesitan conectores personalizados
• Optimización de flujos — combinar múltiples skills en uno solo y más eficiente ahorra tiempo
• Control de calidad — crear tus propios skills significa que sabes exactamente lo que hacen
• Ventaja competitiva — flujos de automatización únicos que tus competidores no tienen

Por qué revisar skills antes de instalarlos

No todos los skills en ClawHub están listos para producción. Antes de instalar un skill de la comunidad:

• Seguridad — un skill podría acceder a tu sistema de archivos, red o credenciales de formas que no esperas
• Calidad — algunos skills son prototipos o pruebas de concepto, no herramientas de producción
• Mantenimiento — skills abandonados pueden no funcionar con versiones más recientes de OpenClaw
• Dependencias — un skill podría requerir servicios externos o claves API que no tienes
• Permisos — entiende exactamente qué acceso solicita un skill antes de concedérselo

Requisitos previos

• OpenClaw instalado y configurado (Guía de inicio rápido)
• Familiaridad con YAML y scripting básico
• Node.js 18+

Paso 1: Instalar las herramientas de desarrollo de Skills

# 1. Skill builder — te guía en la creación de skills bien estructurados
npx clawhub@latest install skill-builder

# 2. Skill reviewer — análisis de calidad y estructura
npx clawhub@latest install skill-reviewer

# 3. Task decomposer — descompone tareas complejas en cadenas de skills
npx clawhub@latest install task-decomposer

Paso 2: Crea tu primer Skill personalizado

Entiende la estructura de un Skill

Un skill de OpenClaw se centra en un archivo SKILL.md — este es el documento de instrucciones principal que le dice al agente de IA cómo realizar una tarea. El skill Skill Builder te guía en la creación de skills bien estructurados siguiendo buenas prácticas.

Una estructura típica de skill se ve así:

my-custom-skill/
  ├── SKILL.md             # Instrucciones principales para el agente
  ├── [topic].md           # Archivos de detalle bajo demanda (se cargan cuando se necesitan)
  ├── references/          # Documentación extensa, ejemplos
  └── scripts/             # Scripts de automatización opcionales

Escribe tu SKILL.md

El SKILL.md es el corazón de tu skill. Pídele a OpenClaw (con el skill Skill Builder instalado) que te ayude a escribirlo:

Help me create a skill that searches a custom API for products.
The API is at https://api.example.com/search and requires an API key.

El Skill Builder te guía a través de:

• Estructura modular — mantener el SKILL.md principal enfocado y usar archivos separados para temas detallados
• Divulgación progresiva — cargar archivos de detalle solo cuando el agente los necesita
• Diseño eficiente en tokens — minimizar el uso de la ventana de contexto
• Entrada/salida clara — definir qué espera y qué devuelve el skill

Ejemplo de SKILL.md

# Product Search Skill

Search the product catalog API for items matching a query.

## Configuration
- `API_URL`: Base URL of the product API
- `API_KEY`: API key for authentication (set as environment variable)

## Usage
When the user asks to search for products, use the API:

GET {API_URL}/search?q={query}
Authorization: Bearer {API_KEY}

## Response Format
Return results as a structured list with name, price, and URL for each product.

Prueba el Skill

Instala tu skill localmente y pruébalo:

clawhub install ./my-custom-skill

Luego úsalo en OpenClaw para verificar que funciona como esperas.

Paso 3: Revisar un Skill de la comunidad

Antes de instalar cualquier skill de ClawHub, revísalo:

clawhub run skill-reviewer --skill "clawhub-username/skill-name"

El revisor analiza el SKILL.md y los archivos de soporte del skill, verificando:

=== Skill Review: awesome-slack-bot ===

## Structure Assessment
✓ SKILL.md is well-organized with clear sections
✓ Description is specific and actionable
✓ Input/output expectations are documented
✓ Usage examples included
⚠ Missing on-demand detail files — all content is in one large SKILL.md

## Quality Score
✓ Frontmatter is complete (name, description, version)
✓ Instructions are token-efficient — progressive disclosure used
✓ Error handling guidance included
⚠ No rate limiting guidance — may hit API limits under heavy use

## Description Quality: 8.5/10
Recommendation: Well-structured skill, ready for use

Qué buscar

Señales de alerta

• El skill solicita permisos que no debería necesitar (p. ej., un skill de búsqueda que pide acceso de escritura a archivos)
• Sin tests ni documentación
• Última actualización hace más de 6 meses
• URLs o credenciales hardcodeadas en el código fuente
• Código ofuscado o minificado

Buenas señales

• Declaraciones de permisos claras que coinciden con el uso real
• Cobertura de tests completa
• Mantenimiento activo y participación de la comunidad
• Código fuente transparente
• Configuración bien documentada

Paso 4: Descomponer tareas complejas

El skill Task Decomposer ayuda a dividir peticiones complejas en pasos ejecutables. Pídele a OpenClaw:

Decompose this task: Monitor competitor pricing pages daily and alert me when prices change

Ejemplo de salida:

=== Task Decomposition ===

Task: Monitor competitor pricing pages daily and alert when prices change

## Skill Chain

1. **browser-use** — Navigate to each competitor's pricing page
   Input: List of competitor URLs
   Output: Page content / screenshots

2. **web-scraper** — Extract pricing data from each page
   Input: Page content
   Output: Structured pricing data (JSON)

3. **file_read** — Load yesterday's pricing data for comparison
   Input: File path to stored data
   Output: Previous pricing data

4. **summarize** — Compare current vs. previous pricing and identify changes
   Input: Current data + previous data
   Output: Change report

5. **telegram** (or email) — Send alert if changes detected
   Input: Change report
   Output: Notification sent

## Required Skills
- browser-use (installed: yes)
- web-scraper (installed: yes)
- summarize (installed: yes)
- telegram (installed: no — install with: npx clawhub@latest install telegram)

## Estimated Setup Time: 20 minutes

De la descomposición al flujo de trabajo

Convierte la descomposición en un flujo de trabajo reutilizable:

# .openclaw/price-monitor.yml
name: competitor-price-monitor
schedule: "0 9 * * *"
steps:
  - skill: browser-use
    action: navigate
    urls:
      - "https://competitor1.com/pricing"
      - "https://competitor2.com/pricing"

  - skill: web-scraper
    action: extract
    format: json
    target: "pricing tables"

  - skill: summarize
    action: compare
    current: "{{step_2.output}}"
    previous: "./data/last-pricing.json"

  - skill: telegram
    action: send
    condition: "changes_detected"
    message: "{{step_3.output}}"

  - action: save
    data: "{{step_2.output}}"
    path: "./data/last-pricing.json"

Paso 5: Publica tu Skill

Cuando tu skill esté listo, publícalo en ClawHub:

clawhub publish my-custom-skill

Antes de publicar, asegúrate de:

• El SKILL.md está completo y bien estructurado
• La descripción es específica y accionable
• No hay secretos hardcodeados en ningún archivo
• El número de versión sigue semver

Solución de problemas

El skill no funciona como se espera

• Verifica que las instrucciones del SKILL.md sean claras y específicas
• Prueba con diferentes prompts para ver si el agente interpreta el skill correctamente
• Revisa las directrices del Skill Builder para errores comunes en las instrucciones

"Permission denied" durante la ejecución del skill

• Revisa a qué accede el skill — archivos, red, credenciales
• Asegúrate de que has concedido los permisos necesarios al instalarlo
• Algunos permisos requieren aprobación explícita del usuario en la primera ejecución

El revisor de skills muestra falsos positivos

• El revisor es conservador — marca todo lo que podría ser una preocupación
• Revisa las advertencias específicas y decide si aplican a tu caso de uso
• No toda advertencia es un problema real — usa tu criterio

El skill publicado no aparece en ClawHub

• La publicación puede tardar unos minutos en propagarse
• Verifica que tu cuenta de ClawHub esté verificada
• Comprueba que el nombre del skill no entre en conflicto con un skill existente