Documentación para OpenClaw

Qué es una skill

Una skill es una capacidad concreta y acotada: conciliar un IVA, redactar una respuesta de soporte, revisar un contrato. No es un agente completo, es una cosa que el agente sabe hacer bien. Se describe una vez y se reutiliza en todos los agentes que la necesiten.

Un agente es la suma de un rol, unas reglas de comportamiento y un conjunto de skills. Las reglas le dicen cómo trabajar; las skills, qué puede hacer.

Estructura de SKILL.md

El archivo empieza con front-matter YAML entre --- y sigue con secciones normales de Markdown. Los títulos de nivel dos son los que se convierten en campos del JSON, así que conviene respetarlos.

---
name: conciliar-iva
title: Conciliar IVA mensual
description: Cruza el libro de compras con el ATS y reporta diferencias.
version: 1.2.0
author: Equipo contable
compatibility:
  - OpenClaw
---

# Conciliar IVA mensual

## Objetivo
Detectar diferencias entre el libro de compras y el anexo transaccional
antes de presentar la declaración.

## Instrucciones
Recibe dos archivos y compara factura por factura. Reporta sólo las
diferencias, nunca un resumen optimista.

## Workflow
1. Normaliza los RUC a 13 dígitos.
2. Cruza por número de autorización.
3. Agrupa las diferencias por tipo.
4. Devuelve una tabla y un total.

## Reglas
- Nunca inventes un valor que no esté en el documento fuente.
- Si falta un dato obligatorio, detente y pídelo.

## Inputs
- libro_compras: CSV o XLSX
- ats: XML del anexo

## Outputs
- tabla de diferencias
- total descuadrado

La misma skill en JSON

Al publicar, el Markdown se convierte en una definición estructurada. No se altera ni una instrucción: sólo se reorganiza para que el agente pueda leerla campo a campo.

{
  "schema": "forja/skill@1",
  "name": "conciliar-iva",
  "title": "Conciliar IVA mensual",
  "version": "1.2.0",
  "compatibility": ["OpenClaw"],
  "objective": "Detectar diferencias entre el libro de compras y el anexo...",
  "workflow": [
    "Normaliza los RUC a 13 dígitos.",
    "Cruza por número de autorización.",
    "Agrupa las diferencias por tipo."
  ],
  "rules": [
    "Nunca inventes un valor que no esté en el documento fuente.",
    "Si falta un dato obligatorio, detente y pídelo."
  ],
  "inputs":  ["libro_compras: CSV o XLSX", "ats: XML del anexo"],
  "outputs": ["tabla de diferencias", "total descuadrado"]
}

Cómo descargar

Abre la ficha del agente o de la skill.
En el panel lateral elige el formato: .md, .json, .txt o .zip.
En un agente puedes desmarcar las habilidades que no vayas a usar antes de bajar el ZIP.

No hace falta iniciar sesión para descargar contenido público.

Cómo instalarlo

Dentro del ZIP de un agente encontrarás esto:

analista-tributario/
├── AGENT.md          ← las reglas del agente
├── agent.json        ← manifiesto con la lista de habilidades
├── README.md
├── manifest.json
└── skills/
    ├── conciliar-iva.json
    ├── conciliar-iva.md
    ├── leer-factura.json
    └── leer-factura.md

Descomprime la carpeta dentro de tu proyecto.
Carga AGENT.md como reglas o prompt de sistema del agente.
Registra los archivos de skills/ como habilidades disponibles.
Si quitaste habilidades, manifest.json ya viene ajustado a tu selección.

Otros agentes

El formato no está atado a OpenClaw. Hoy se marcan como compatibles: OpenClaw, Claude, ChatGPT, Gemini, Otros. Si tu agente lee texto, el .md le sirve; si acepta herramientas declaradas, usa el .json.

Buenas prácticas

Una skill, una responsabilidad. Si necesita tres párrafos de excepciones, probablemente son dos skills.
Escribe las reglas en negativo también. Lo que el agente no debe hacer evita más errores que lo que sí.
Declara entradas y salidas. Sin eso el agente improvisa el formato.
Versiona de verdad. Cambio de comportamiento es mayor, matiz es menor, corrección es parche.
Incluye un ejemplo real. Un caso concreto vale más que tres frases abstractas.

Versionado

Se usa MAJOR.MINOR.PATCH. Cambia el primer número cuando el comportamiento esperado deja de ser el mismo, el segundo cuando añades algo compatible y el tercero cuando corriges una errata o afinas una instrucción.

Cómo usar esto con OpenClaw