Quería añadir una función a OpenClaw que no existía: un resumen de Hacker News que sintetiza las historias principales cada mañana y las publica en mi Slack. No había nada como esto existente como una habilidad. Así que construí una.
Me llevó cuatro horas la primera vez, incluyendo dos horas de leer mal la especificación de la habilidad. La segunda habilidad que construí tomó 45 minutos. Para la quinta, podía hacerlo en 30 minutos. Este es el proceso, despojado de todos los errores que cometí en el camino.
Lo Que Realmente Es una Habilidad
Una habilidad es una carpeta con instrucciones y scripts opcionales. Como mínimo, contiene un archivo SKILL.md — un documento markdown que le dice a OpenClaw qué hace la habilidad, cuándo activarla y cómo utilizarla.
Eso es todo. Sin compilación. Sin registro de paquetes. Sin sistema de construcción. Una habilidad es un documento que OpenClaw lee cuando necesita realizar una tarea específica.
La habilidad más simple posible:
Una carpeta llamada daily-hn-digest que contiene un solo archivo, SKILL.md, con instrucciones como: “Cuando el usuario pida un resumen de Hacker News, usa la herramienta web_search para encontrar las historias principales actuales en Hacker News, resume cada una en 2-3 oraciones y formatea el resultado como una lista con viñetas.”
Eso funciona. El agente lee las instrucciones, las sigue y produce un resumen de Hacker News. No se requiere código.
Añadiendo Complejidad Cuando la Necesitas
La habilidad básica maneja casos simples. Para flujos de trabajo más complejos, añades:
Archivos de referencia. Mi habilidad de Hacker News incluye una carpeta refs/ con ejemplos de salidas — mostrando al agente cómo se ve un buen resumen. Esto mejora dramáticamente la consistencia. En lugar de “resume historias,” el agente ve “aquí hay un buen resumen — ajusta este formato.”
Scripts. Algunas habilidades incluyen scripts de shell o scripts de Python para tareas que la IA no puede realizar directamente. Mi habilidad de resumen incluye un script que obtiene la API de Hacker News (más rápida y confiable que el web scraping). Las instrucciones de la habilidad indican al agente que ejecute el script y procese su salida.
Configuración. Las habilidades pueden leer de archivos de configuración. Mi habilidad de resumen tiene un config.yaml que especifica cuántas historias incluir (por defecto: 10), qué categorías priorizar y el formato de salida (Slack, email o texto plano).
La Estructura Que Funciona
Después de construir alrededor de una docena de habilidades, esta es la estructura de carpeta en la que me he asentado:
my-skill/
├── SKILL.md — Instrucciones principales (requerido)
├── refs/ — Ejemplos de entradas y salidas (opcional)
├── scripts/ — Scripts auxiliares (opcional)
└── config.yaml — Configuración (opcional)
SKILL.md es el archivo más importante. Debe incluir:
1. Una descripción clara de lo que hace la habilidad
2. Cuándo debe activarse la habilidad (condiciones de activación)
3. Instrucciones paso a paso para el flujo de trabajo
4. Orientación sobre manejo de errores
5. Ejemplos de buena salida
La calidad de tu SKILL.md determina directamente la calidad de la habilidad. Un SKILL.md vago produce resultados inconsistentes. Un SKILL.md preciso produce resultados confiables.
Escribiendo Buenas Instrucciones
La mayor lección que aprendí: escribe SKILL.md como si estuvieras entrenando a un nuevo empleado, no como si estuvieras escribiendo documentación.
Malo: “Obtén historias de Hacker News y resúmelas.”
Bueno: “Obtén las 10 principales historias de la API de Hacker News utilizando el script en scripts/fetch-hn.sh. Para cada historia, escribe un resumen de 2-3 oraciones que cubra: qué ocurrió, por qué es importante y la reacción de la comunidad (si es notable). Formatea como una lista numerada con el título de la historia como un enlace.”
La versión buena elimina la ambigüedad. El agente sabe exactamente qué hacer, qué formato usar y qué información incluir. No hay lugar para interpretaciones creativas donde no lo deseas.
Incluir modos de fallo. “Si la API de Hacker News no está disponible, usa web_search como opción alternativa. Si hay menos de 5 historias disponibles, indícalo en la salida y procede con lo que esté disponible. No fabriques historias.”
Incluir límites. “No editorialices. No añadas opiniones sobre las historias. No omitas historias porque parezcan poco importantes. Presenta todas las historias principales de manera neutral.”
Poniendo a Prueba Tu Habilidad
El proceso de prueba es simple: instala la habilidad, actívala y verifica la salida.
Para mi habilidad de Hacker News:
1. Copia la carpeta en el directorio de habilidades
2. Reinicia OpenClaw (o espera a que detecte la nueva habilidad)
3. Escribe “Dame un resumen de Hacker News”
4. Verifica la salida contra las expectativas
5. Ajusta SKILL.md según lo que salió mal
Típicamente paso por 3-4 ciclos de revisión antes de estar satisfecho. Problemas comunes: el agente omitiendo pasos (añadir instrucciones más explícitas), formato inconsistente (añadir un ejemplo de salida), o incluyendo información que no deseabas (añadir límites explícitos).
Publicación y Compartición
Una vez que tu habilidad funcione, puedes compartirla a través de ClawHub — el mercado de habilidades de la comunidad. Sube tu carpeta de habilidad, añade una descripción y otros usuarios pueden instalarla con un solo comando.
Antes de publicar, limpia tu habilidad: elimina cualquier configuración personal, añade un README con instrucciones de configuración y pruébala en una instalación nueva de OpenClaw para asegurarte de que no dependa de tu entorno local.
Las mejores habilidades comunitarias están enfocadas (hacen una cosa bien), bien documentadas (SKILL.md claro) y son confiables (manejan fallos de manera elegante). Las peores son vagas (“usa IA para hacer cosas”), mal documentadas o frágiles.
Mis Habilidades Personalizadas Favoritas
Más allá del resumen de Hacker News, aquí están las habilidades personalizadas que uso a diario:
Preparación de reuniones. Antes de una reunión, digo “prepárate para mi reunión a las 2pm con [cliente].” La habilidad extrae correos recientes, actualizaciones de proyectos y problemas abiertos relacionados con ese cliente y compila un briefing de una página.
Asistente de revisión de código. Cuando subo código, la habilidad lo revisa según los estándares de codificación de nuestro equipo (documentados en un archivo de referencia) y publica comentarios en nuestro canal de equipo.
Generador de retro semanal. Cada viernes, la habilidad compila lo que logré esa semana (de los commits de GitHub, mensajes de Slack y tareas completadas) y elabora un resumen semanal.
Cada una de estas tomó alrededor de una hora para construir. Cada una ahorra de 15 a 30 minutos por uso. El retorno de inversión es obvio.
🕒 Published: