Authoring

Schrijft en herschrijft SKILL.md en agent-bestanden volgens projectconventies

Door OdradekAI · OdradekAI/bundles-forge

Getest · Werkt ★ 8.8/10

Authoring — Schrijft en herschrijft SKILL.md en agent-bestanden volgens projectconventies

Wat het doet

Begeleidt het schrijven, voltooien, integreren of verbeteren van SKILL.md en agents/*.md inhoud binnen een bundle-plugin, met vier expliciete paden (new, integrate, complete, improve) plus conventies voor beschrijvingen, body-structuur en tokenbudget. Activeert bij het opstellen of herschrijven van skill/agent-definities, het invullen van gescaffolde stubs, het aanpassen van externe skills, of het corrigeren van beschrijvingen die niet betrouwbaar activeren. Validatie voert de bundles-forge audit-skill CLI uit met een gedocumenteerde handmatige checklist als terugval.

Testrapport

SKILL.md opgehaald via de GitHub API tree + raw; alle drie de in de body gerefereerde bestanden (skill-writing-guide.md, quality-checklist.md, agent-authoring-guide.md) retourneerden HTTP 200. Frontmatter parseert met name+description; geen beveiligingsrisico's; de enige externe afhankelijkheid is de bundles-forge audit-skill CLI, waarvoor de skill een handmatige terugval documenteert. Uitvoer-test: twee SKILL.md-concepten geschreven voor een hypothetische commit-message skill. Baseline gebruikte een Title-Case naam en een workflow-samenvattende beschrijving ("This skill helps you write... formats them...") — precies het anti-patroon waar de skill voor waarschuwt — zonder skill-type declaratie, geen waarom-gemotiveerde stappen, geen Common Mistakes/Inputs/Outputs/Integration secties, eindigend in kale Always/Never-richtlijnen. Het volgen van de skill produceerde een kebab-case naam, een 188-teken "Use when..." trigger-only beschrijving, een Overzicht met kernprincipe + skill-type + aankondigingsregel, processtappen die elk waarom rechtvaardigen, een 4-rijige Common Mistakes tabel, en Inputs/Outputs/Integration met artefact-ID's. Concreet, waargenomen verschil.

Getest op: 2026-07-31 · Claude Code 2.x (agent harness)

Installatie

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

Commando's en voorbeeldprompts

/authoringSchrijft en herschrijft SKILL.md en agent-bestanden volgens projectconventies

Skills reageren op gewone verzoeken — geen commando's om te onthouden. Na installatie activeren prompts zoals deze de skill (in het Engels):

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

Volledig rapport (Engels) →