Authoring

Pisze i przepisuje pliki SKILL.md i agentów zgodnie z konwencjami projektu

Autor: OdradekAI · OdradekAI/bundles-forge

Testowano · Działa ★ 8.8/10

Authoring — Pisze i przepisuje pliki SKILL.md i agentów zgodnie z konwencjami projektu

Co robi ten skill

Prowadzi przez pisanie, uzupełnianie, integrowanie lub ulepszanie zawartości SKILL.md i agents/*.md wewnątrz bundle-plugin, z czterema jawnymi ścieżkami (new, integrate, complete, improve) plus konwencjami dla opisów, struktury treści i budżetu tokenów. Uruchamia się podczas tworzenia lub przepisywania definicji umiejętności/agentów, wypełniania szkieletowych stubów, adaptowania zewnętrznych umiejętności lub naprawiania opisów, które nie wyzwalają się niezawodnie. Walidacja uruchamia bundles-forge audit-skill CLI z udokumentowanym ręcznym fallbackiem listy kontrolnej.

Raport z testu

Pobrano SKILL.md przez drzewo GitHub API + raw; wszystkie trzy pliki odwołujące się w treści (skill-writing-guide.md, quality-checklist.md, agent-authoring-guide.md) zwróciły HTTP 200. Frontmatter parsowany z name+description; brak zagrożeń bezpieczeństwa; jedyną zewnętrzną zależnością jest bundles-forge audit-skill CLI, dla którego umiejętność dokumentuje ręczny fallback. Test wyjścia: napisałem dwa szkice SKILL.md dla hipotetycznej umiejętności wiadomości commit. Bazowy używał nazwy w Title-Case i opisu podsumowującego przepływ pracy ("This skill helps you write... formats them...") — dokładnie antywzorzec, przed którym ostrzega umiejętność — bez deklaracji typu umiejętności, bez kroków motywowanych pytaniem 'dlaczego', bez sekcji Common Mistakes/Inputs/Outputs/Integration, kończąc na samych dyrektywach Always/Never. Postępowanie zgodnie z umiejętnością wygenerowało nazwę w kebab-case, 188-znakowy opis "Use when..." tylko wyzwalający, przegląd z podstawową zasadą + typem umiejętności + linią ogłoszenia, kroki procesu, z których każdy uzasadniał 'dlaczego', 4-wierszową tabelę Common Mistakes oraz Inputs/Outputs/Integration z identyfikatorami artefaktów. Konkretna, zaobserwowana różnica.

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

Instalacja

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

Komendy i przykładowe prompty

/authoringPisze i przepisuje pliki SKILL.md i agentów zgodnie z konwencjami projektu

Skille uruchamiają się na zwykłe polecenia — bez komend do zapamiętania. Po instalacji aktywują go prompty takie jak te (po angielsku):

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

Pełny raport →