Authoring

Escribe y reescribe SKILL.md y archivos de agente según las convenciones del proyecto

Probado · Funciona ★ 8.8/10

Qué hace

Guía la escritura, finalización, integración o mejora del contenido de SKILL.md y `agents/*.md` dentro de un `bundle-plugin`, con cuatro rutas explícitas (new, integrate, complete, improve) más convenciones para descripciones, estructura del cuerpo y presupuesto de tokens. Se activa al autorizar o reescribir definiciones de habilidades/agentes, rellenar `stubs` andamiados, adaptar habilidades externas o corregir descripciones que no se activan de forma fiable. La validación ejecuta el CLI `bundles-forge audit-skill` con un respaldo de lista de verificación manual documentado.

Informe de la prueba

Se obtuvo SKILL.md a través del árbol de la API de GitHub + raw; los tres archivos referenciados en el cuerpo (skill-writing-guide.md, quality-checklist.md, agent-authoring-guide.md) devolvieron HTTP 200. El frontmatter se analiza con `name`+`description`; sin problemas de seguridad; la única dependencia externa es el CLI `bundles-forge audit-skill`, para el cual la habilidad documenta un respaldo manual. Prueba de salida: escribí dos borradores de SKILL.md para una habilidad hipotética de mensaje de `commit`. La línea base usó un nombre en `Title-Case` y una descripción de resumen de flujo de trabajo ("This skill helps you write... formats them...") — exactamente el anti-patrón contra el que advierte la habilidad — sin declaración de tipo de habilidad, sin pasos motivados por el porqué, sin secciones de Errores Comunes/Entradas/Salidas/Integración, terminando en directivas `Always`/`Never` desnudas. Siguiendo la habilidad se produjo un nombre en `kebab-case`, una descripción de 188 caracteres "Use when..." solo para activación, una Visión General con principio central + tipo de habilidad + línea de anuncio, pasos de proceso cada uno justificando el porqué, una tabla de Errores Comunes de 4 filas, y Entradas/Salidas/Integración con IDs de artefactos. Diferencia concreta y observada.

Probado el: 2026-07-31 · Claude Code 2.x (agent harness)

Instalación

git clone --depth 1 https://github.com/OdradekAI/bundles-forge.git /tmp/authoring-src
mkdir -p ~/.claude/skills
cp -R /tmp/authoring-src/skills/authoring ~/.claude/skills/authoring
# Standalone: works without extra deps; references/ (skill-writing-guide.md, quality-checklist.md,
#   agent-authoring-guide.md) ship inside the copied dir.
# Optional validation step: SKILL.md's Post-Action Validation runs `bundles-forge audit-skill <dir>`,
#   which needs the full plugin. Install via Claude Code marketplace instead to get that CLI:
#   /plugin marketplace add OdradekAI/bundles-forge
#   /plugin install bundles-forge@bundles-forge-dev
# Without the CLI the skill falls back to references/quality-checklist.md (manual review).

Comandos y prompts de ejemplo

/authoringEscribe y reescribe SKILL.md y archivos de agente según las convenciones del proyecto

Los skills se activan con peticiones en lenguaje natural, sin comandos que memorizar. Tras instalarlo, prompts como estos lo activan (en inglés):

Rewrite this SKILL.md for better triggering
Fill in this scaffolded skill stub
Integrate this external skill into our bundle

Informe completo →