Guía / artifact / SKILL

Artifact SKILL: empaqueta instrucciones reusables

Usa un artifact SKILL para una capacidad reusable descrita con markdown y apoyada por referencias, scripts o assets opcionales.

La forma de una skill

Una skill tiene content.entrypoint apuntando a su archivo markdown principal. El entrypoint se lee del bundle descargado y los providers copian el directorio de la skill conservando archivos de apoyo.

Usa el layout convencional SKILL.md en el root del paquete salvo que el contrato específico de la herramienta requiera otro path relativo. El path distingue mayúsculas en muchos sistemas y también debe aparecer en files.

{ "entrypoint": "SKILL.md" }

Qué poner en files

files es la allow-list del release. Incluye el entrypoint y cada archivo que este referencia. Los patrones son relativos a path y soportan **.

SKILL.md Entrypoint requerido en el layout común. Explica cuándo aplica la skill, qué hace y cómo debe comportarse.
references/** Documentos largos opcionales. Enlázalos desde SKILL.md con paths relativos.
scripts/** Scripts auxiliares opcionales. Mantenlos seguros, deterministas y documentados; los ejecutables binarios son rechazados por el preflight.
assets/** Assets o templates de texto opcionales que necesite la skill.

Entrada de manifest de ejemplo

Este paquete deja explícito el entrypoint e incluye todos los archivos de apoyo. El tag público puede tener namespace; la key local del deployment es auditor.

{
  "auditor": {
    "kind": "artifact",
    "path": "packages/auditor",
    "tag": "vendor/security-auditor",
    "version": "1.2.0",
    "visibility": "public",
    "artifact_type": "SKILL",
    "content": { "entrypoint": "SKILL.md" },
    "files": ["SKILL.md", "references/**", "scripts/**"]
  }
}

Qué materializa install

Los providers soportados leen el entrypoint y copian el bundle a su ubicación administrada de skills, agregando metadata de ownership. Un provider puede aplicar, saltar o reportar una limitación de tipo; revisa el reporte de install, no asumas paths idénticos.

Usa hubbound install artifact <author/tag>@<version> o pinea bajo dependencies y corre hubbound install pelado desde el root del proyecto.

$ hubbound deploy auditor --path . --dry-run

$ hubbound deploy auditor --path .

$ hubbound install artifact vendor/security-auditor@1.2.0