Authoring

Écrit et réécrit les fichiers SKILL.md et agent selon les conventions du projet

Testé · Fonctionne ★ 8.8/10

Ce que fait

Guide l'écriture, la complétion, l'intégration ou l'amélioration du contenu de SKILL.md et agents/*.md à l'intérieur d'un bundle-plugin, avec quatre chemins explicites (new, integrate, complete, improve) plus des conventions pour les descriptions, la structure du corps et le budget de tokens. Se déclenche lors de la rédaction ou de la réécriture de définitions de skills/agents, du remplissage de stubs échafaudés, de l'adaptation de skills externes ou de la correction de descriptions qui ne se déclenchent pas de manière fiable. La validation exécute la CLI bundles-forge audit-skill avec une liste de contrôle manuelle documentée en cas de repli.

Rapport de test

SKILL.md a été récupéré via l'arborescence de l'API GitHub + brut ; les trois fichiers référencés dans le corps (skill-writing-guide.md, quality-checklist.md, agent-authoring-guide.md) ont renvoyé HTTP 200. Le frontmatter est parsé avec name+description ; pas de failles de sécurité ; la seule dépendance externe est la CLI bundles-forge audit-skill, pour laquelle la skill documente un repli manuel. Test de sortie : j'ai écrit deux brouillons de SKILL.md pour une skill hypothétique de message de commit. La ligne de base utilisait un nom en Title-Case et une description de résumé de workflow ("This skill helps you write... formats them...") — exactement l'anti-pattern contre lequel la skill met en garde — sans déclaration de type de skill, sans étapes motivées par le pourquoi, sans sections Common Mistakes/Inputs/Outputs/Integration, se terminant par de simples directives Always/Never. Suivre la skill a produit un nom en kebab-case, une description de 188 caractères "Use when..." uniquement déclenchante, un aperçu avec principe fondamental + type de skill + ligne d'annonce, des étapes de processus justifiant chacune le pourquoi, un tableau de 4 lignes Common Mistakes, et des Inputs/Outputs/Integration avec des ID d'artefacts. Différence concrète et observée.

Testé le: 2026-07-31 · Claude Code 2.x (agent harness)

Installation

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

Commandes et exemples de prompts

/authoringÉcrit et réécrit les fichiers SKILL.md et agent selon les conventions du projet

Les skills se déclenchent sur des demandes en langage courant — aucune commande à retenir. Après installation, des prompts comme ceux-ci l'activent (en anglais) :

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

Rapport complet →