Authoring

Schreibt und überarbeitet SKILL.md und Agenten-Dateien gemäß Projektkonventionen

von OdradekAI · OdradekAI/bundles-forge

Getestet · Funktioniert ★ 8.8/10

Authoring — Schreibt und überarbeitet SKILL.md und Agenten-Dateien gemäß Projektkonventionen

Was es kann

Leitet beim Schreiben, Vervollständigen, Integrieren oder Verbessern von SKILL.md- und agents/*.md-Inhalten innerhalb eines Bundle-Plugins, mit vier expliziten Pfaden (new, integrate, complete, improve) plus Konventionen für Beschreibungen, Textstruktur und Token-Budget. Wird ausgelöst beim Erstellen oder Überarbeiten von Skill-/Agenten-Definitionen, Ausfüllen von Gerüst-Stubs, Anpassen externer Skills oder Beheben von Beschreibungen, die nicht zuverlässig auslösen. Die Validierung führt die bundles-forge audit-skill CLI mit einem dokumentierten manuellen Checklisten-Fallback aus.

Testbericht

SKILL.md über den GitHub API-Baum + raw abgerufen; alle drei im Text referenzierten Dateien (skill-writing-guide.md, quality-checklist.md, agent-authoring-guide.md) gaben HTTP 200 zurück. Frontmatter parst mit name+description; keine Sicherheitsmängel; die einzige externe Abhängigkeit ist die bundles-forge audit-skill CLI, für die der Skill einen manuellen Fallback dokumentiert. Ausgabe-Test: Zwei SKILL.md-Entwürfe für einen hypothetischen Commit-Nachrichten-Skill geschrieben. Die Baseline verwendete einen Title-Case-Namen und eine Workflow-Zusammenfassungsbeschreibung („This skill helps you write... formats them...“) – genau das Anti-Muster, vor dem der Skill warnt – ohne Skill-Typ-Deklaration, ohne warum-motivierte Schritte, ohne Abschnitte für Common Mistakes/Inputs/Outputs/Integration, endend in bloßen Always/Never-Direktiven. Die Befolgung des Skills führte zu einem Kebab-Case-Namen, einer 188-Zeichen „Use when...“-Trigger-Beschreibung, einer Übersicht mit Kernprinzip + Skill-Typ + Ankündigungszeile, Prozessschritten, die jeweils das Warum rechtfertigen, einer 4-zeiligen Common Mistakes-Tabelle und Inputs/Outputs/Integration mit Artefakt-IDs. Konkreter, beobachteter Unterschied.

Getestet am: 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).

Befehle & Beispiel-Prompts

  • /authoringSchreibt und überarbeitet SKILL.md und Agenten-Dateien gemäß Projektkonventionen

Skills reagieren auf normale Anfragen — keine Slash-Befehle nötig. Nach der Installation aktivieren Prompts wie diese den Skill (auf Englisch):

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