Crear y Publicar Skills

Crea tu propia skill y compártela en el Marketplace de Skills

Cualquier persona con una cuenta de Claw Buff puede crear y publicar skills en el Marketplace de Skills.

Crear una Skill

Navega al Marketplace de Skills y haz clic en Publicar Skill, o ve directamente al Editor de Skills.

El Editor

El editor de skills tiene dos paneles:

Panel izquierdo — contenido del SKILL.md:

Escribe las instrucciones de tu skill en Markdown. Este es el núcleo de la skill — el documento de prompt que enseña al agente a realizar una tarea. También puedes subir archivos de script opcionales (JS/TS) para comportamientos avanzados.

Panel derecho — Metadatos:

Campo	Requerido	Descripción
Nombre	Sí	Nombre a mostrar (mín. 2 caracteres)
Descripción	Sí	Resumen corto mostrado en la tarjeta
Categoría	Sí	Una de: Desarrollo, Productividad, Comunicación, etc.
Etiquetas	No	Labels separadas por coma para descubrimiento
Versión	Sí	Versión semántica (ej: `1.0.0`)

Escribir un buen SKILL.md

La calidad de una skill depende enteramente de la claridad de sus instrucciones. Sigue esta estructura:

---
name: my-skill
description: Lo que hace esta skill en una frase
version: 1.0.0
---

# My Skill

## Descripción General
Explicación breve de lo que el agente puede hacer con esta skill.

## Comandos / Flujos de Trabajo
Instrucciones paso a paso que el agente debe seguir.
Sé específico sobre qué herramientas usar y en qué orden.

## Ejemplos
Muestra ejemplos concretos de entrada/salida para que
el agente entienda el comportamiento esperado.

## Limitaciones
Lo que esta skill no puede hacer o no debería intentar.

Las mejores skills son enfocadas y específicas. Una skill que hace una cosa bien es más útil que una que intenta cubrir todo. Piensa "Revisor de PR de GitHub" y no "ayudante general de código."

Guardar y Publicar

Tienes dos opciones:

Guardar Borrador — Guarda la skill sin publicar. Solo tú puedes ver borradores. Útil para skills en desarrollo.
Publicar — Envía la skill para revisión y la hace disponible en el marketplace una vez aprobada.

Proceso de Revisión

Cuando publicas una skill, sucede lo siguiente:

Escaneo de seguridad automatizado — Los archivos de script (si los hay) se escanean en busca de patrones maliciosos conocidos (shells reversos, exfiltración de datos, robo de credenciales).
Estado de revisión — Las skills con scripts que pasan el escaneo quedan como "pendiente de revisión." Las skills sin scripts (solo SKILL.md) se aprueban automáticamente.
Notificación — Serás notificado cuando tu skill sea aprobada o rechazada. Las skills rechazadas incluyen una nota de revisión explicando el motivo.

Las skills que contienen solo un SKILL.md (sin archivos de script) se aprueban automáticamente ya que son documentos de prompt puros sin código ejecutable. Añadir scripts activa el pipeline de revisión de seguridad.

Gestionar tus Skills

Mis Skills

Haz clic en la pestaña Mis Skills en la página del marketplace para ver todas tus skills y sus estados:

Estado	Significado
Publicada (verde)	Disponible en el marketplace, visible para todos
Pendiente de Revisión (ámbar)	Enviada, esperando aprobación
Rechazada (rojo)	Rechazada con nota de revisión — edita y reenvía
No Publicada (gris)	Borrador o despublicada manualmente

Editar

Haz clic en cualquiera de tus skills para abrirla en el editor. Puedes actualizar:

Contenido del SKILL.md
Metadatos (nombre, descripción, categoría, etiquetas)
Número de versión
Archivos de script

Los cambios en skills publicadas toman efecto inmediatamente después de guardar.

Despublicar

Para eliminar temporalmente una skill del marketplace sin borrarla:

Abre la skill en el editor
Haz clic en Despublicar en la zona de peligro

La skill se convierte en borrador. Puedes republicarla en cualquier momento.

Eliminar

Para eliminar permanentemente una skill:

Abre la skill en el editor
Haz clic en Eliminar en la zona de peligro
Confirma la eliminación

La eliminación es permanente y no se puede deshacer. Si usuarios ya han instalado tu skill, las copias instaladas permanecen en sus agentes, pero no habrá más actualizaciones disponibles.

Mejores Prácticas

Sé específico en las instrucciones. "Ayuda al usuario con GitHub" es vago. "Usa gh pr create para crear un pull request con los cambios staged" es accionable.
Incluye ejemplos. Muestra al agente cómo son buenas entradas y salidas. Esto mejora dramáticamente la fiabilidad de la skill.
Declara dependencias. Si tu skill necesita una API key o binario, menciónalo claramente en el frontmatter y la descripción del SKILL.md.
Versiona significativamente. Incrementa la versión cuando hagas cambios. Los usuarios y la plataforma rastrean el historial de versiones.
Prueba antes de publicar. Instala tu skill en tu propio agente y verifica que funciona como se espera antes de hacerla pública.
Escribe una descripción clara. Esto es lo primero que ven los usuarios. Sé concreto — ¿qué hará realmente esta skill por su agente?