Sistema de habilidades

Una habilidad (Skill) es un paquete de capacidades para el Agent: un directorio centrado en un archivo SKILL.md que contiene instrucciones de operación, scripts y material de referencia. El Agent lee estos contenidos según sea necesario al ejecutar una tarea y así puede hacer algo que de otro modo no sabría hacer, como generar un documento de Word con índice y encabezado.

Qué es una habilidad

Cada habilidad es un directorio que contiene, como mínimo, un archivo SKILL.md: en el frontmatter se indican name y description, y el cuerpo son las instrucciones de operación destinadas al Agent. El directorio también puede incluir adjuntos (scripts, documentos de referencia, plantillas de configuración) y declarar dependencias y servidores MCP.

---
name: weekly-report-style
description: 生成周报 Excel 时统一使用团队的配色与表头规范
---

# 使用说明

正文写给 Agent 看：什么时候用这个技能、
按什么步骤做、附带的脚本和参考文件怎么用。

Las habilidades usan divulgación progresiva: normalmente el Agent solo ve el nombre y la descripción de cada habilidad, y solo carga el cuerpo completo y los adjuntos cuando determina que la tarea actual requiere una habilidad concreta. De este modo, aunque haya muchas habilidades instaladas, no se introduce todo el contenido en cada conversación.

Habilidades del sistema y habilidades instaladas por el usuario

Las habilidades generales del sistema preinstaladas en la plataforma se dividen principalmente en dos tipos: generación de documentos de Office (docx / xlsx / pptx / pdf) y habilidades de desarrollo (frontend, full-stack, iOS, Android, Flutter, React Native, etc.). En la página «Gestión de habilidades» de la consola puede ver la lista completa, y al abrir cualquier habilidad puede consultar su versión, sus adjuntos y el texto completo de SKILL.md.

Generación de documentos de Office

Este conjunto de habilidades del sistema permite que los pasos del Agent produzcan directamente archivos de documentos de oficina, y no solo texto Markdown:

Uso típico: en un workflow de informe diario, un paso del Agent usa la habilidad xlsx para producir una hoja de informe semanal con formato, que se descarga junto con los artefactos de la ejecución o se envía directamente a Slack / correo. Los artefactos también pueden publicarse como enlace público; consulteIntercambio público de productos.

Mercado de habilidades: instalación y versiones

La página «Mercado de habilidades ClawHub» de la consola se conecta al registro de ClawHub. Busque por palabra clave, consulte la versión, el autor, la cantidad de descargas y la fecha de actualización de cada habilidad, y haga clic en instalar para agregarla a su cuenta.

# 搜索市场
curl "https://braidrun.com/api/skills/market/search?query=testing&limit=10" \
  -H "Authorization: Bearer <token>"

# 安装（安装状态只记在你自己的账号下）
curl -X POST https://braidrun.com/api/skills/market/<slug>/install \
  -H "Authorization: Bearer <token>"

# 升级到最新版本
curl -X POST https://braidrun.com/api/skills/market/<slug>/upgrade \
  -H "Authorization: Bearer <token>"

• Las habilidades tienen número de versión. Para las habilidades instaladas, en la página «Gestión de habilidades» haga clic en «Buscar actualizaciones»; la actualización vuelve a descargar la versión más reciente
• Solo las habilidades instaladas desde el mercado siguen el flujo de actualización; las habilidades importadas por ZIP no tienen origen de actualización, basta con volver a importarlas
• La desinstalación solo elimina la instalación en su propia cuenta y no afecta a otros usuarios que tengan instalada la misma habilidad
• También puede subir un ZIP para importar habilidades propias: el paquete debe contener un archivo SKILL.md con los campos name y description válidos; el tamaño total tras la descompresión no debe superar los 100MB

Habilitar / deshabilitar por usuario

En la página «Gestión de habilidades», cada habilidad tiene su propio interruptor. El estado de habilitado / deshabilitado se registra en su propia cuenta: si deshabilita una habilidad del sistema, deja de ser visible para su Agent, sin afectar a otros usuarios. Las habilidades instaladas de forma privada por otros usuarios ni las ve ni se cargan.

Ámbito del Agent: limitar qué habilidades puede usar un Agent

Además del interruptor a nivel de cuenta, en la configuración del Agent puede acotar un ámbito de habilidades más reducido para un Agent individual. Campos habituales:

• Interruptor del subsistema de Skills: al desactivarlo, este Agent no usa ninguna habilidad
• Modo de lista blanca: al activarlo, solo las habilidades de la lista blanca son detectables por este Agent; las habilidades integradas se agregan automáticamente a la lista blanca
• Lista de deshabilitadas: lista negra que sigue vigente aunque el modo de lista blanca esté desactivado
• Cantidad máxima de habilidades por solicitud: limita cuántas habilidades se inyectan en una sola solicitud
• Búsqueda y descarga automáticas: desactivada por defecto; al activarla, cuando el Agent detecte que le falta una capacidad localmente, buscará y descargará automáticamente nuevas habilidades en ClawHub, lo que introduce descargas externas; úsela con precaución en entornos empresariales

En tiempo de ejecución, la plataforma combina la configuración del Agent con su estado a nivel de usuario para determinar el ámbito de habilidades finalmente vigente: las habilidades que haya deshabilitado en la página «Gestión de habilidades» no estarán disponibles para ninguno de los Agents de esa ejecución.

Configuración en tiempo de ejecución

Algunas habilidades requieren completar parámetros o credenciales antes de funcionar, por ejemplo un API token de un servicio externo. Las habilidades con plantilla de configuración muestran en su tarjeta «Configurada / Pendiente de configurar»; haga clic en «Configurar Skill» y complete los campos.

• Los campos sensibles (token, contraseñas, claves privadas, etc.) se muestran enmascarados tras guardarse y no se devuelve el texto en claro; si se envían con la máscara intacta, se conserva el valor anterior
• Las habilidades que usted mismo instala las puede configurar usted; la configuración en tiempo de ejecución de las habilidades del sistema solo la puede modificar un administrador

Endpoints habituales

Páginas relacionadas

• Explicación detallada de la configuración del Agente
• Biblioteca de módulos integrada
• Intercambio público de productos