Authoring

Scrive e riscrive SKILL.md e file agent secondo le convenzioni di progetto

Promosso ★ 8.8/10

Cosa fa

Guida la scrittura, il completamento, l'integrazione o il miglioramento del contenuto di SKILL.md e agents/*.md all'interno di un bundle-plugin, con quattro percorsi espliciti (new, integrate, complete, improve) più convenzioni per descrizioni, struttura del corpo e budget di token. Si attiva quando si creano o riscrivono definizioni di skill/agenti, si riempiono stub scaffoldati, si adattano skill esterne o si correggono descrizioni che non si attivano in modo affidabile. La validazione esegue la CLI bundles-forge audit-skill con un fallback manuale documentato tramite checklist.

Rapporto di test

Recuperato SKILL.md tramite l'albero API GitHub + raw; tutti e tre i file di riferimento nel corpo (skill-writing-guide.md, quality-checklist.md, agent-authoring-guide.md) hanno restituito HTTP 200. Il frontmatter viene parsato con name+description; nessun problema di sicurezza; l'unica dipendenza esterna è la CLI bundles-forge audit-skill, per la quale la skill documenta un fallback manuale. Test di output: ho scritto due bozze di SKILL.md per una ipotetica skill di messaggi di commit. Il baseline utilizzava un nome in Title-Case e una descrizione riassuntiva del workflow ("This skill helps you write... formats them...") — esattamente l'anti-pattern contro cui la skill avverte — senza dichiarazione del tipo di skill, senza passaggi motivati dal perché, senza sezioni Common Mistakes/Inputs/Outputs/Integration, terminando con direttive Always/Never nude. Seguendo la skill è stato prodotto un nome in kebab-case, una descrizione di 188 caratteri "Use when..." solo per il trigger, una Overview con principio fondamentale + tipo di skill + riga di annuncio, passaggi di processo ciascuno che giustifica il perché, una tabella Common Mistakes di 4 righe e sezioni Inputs/Outputs/Integration con ID artefatto. Differenza concreta e osservata.

Testato il: 2026-07-31 · Claude Code 2.x (agent harness)

Installazione

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).

Comandi e prompt di esempio

/authoringScrive e riscrive SKILL.md e file agent secondo le convenzioni di progetto

Gli skill si attivano con richieste in linguaggio naturale, senza comandi da ricordare. Dopo l'installazione, prompt come questi lo attivano (in inglese):

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

Rapporto completo →