Authoring

Píše a přepisuje SKILL.md a agent soubory podle konvencí projektu

od OdradekAI · OdradekAI/bundles-forge

Otestováno · Funguje ★ 8.8/10

Authoring — Píše a přepisuje SKILL.md a agent soubory podle konvencí projektu

Co umí

Navádí psaní, dokončování, integraci nebo zlepšování obsahu SKILL.md a agents/*.md uvnitř bundle-pluginu, se čtyřmi explicitními cestami (new, integrate, complete, improve) plus konvencemi pro popisy, strukturu těla a rozpočet tokenů. Spouští se při autorství nebo přepisování definic skillů/agentů, vyplňování scaffoldovaných stubů, adaptaci externích skillů nebo opravě popisů, které se nespouštějí spolehlivě. Validace spouští bundles-forge audit-skill CLI s zdokumentovaným manuálním kontrolním seznamem jako záložním řešením.

Testovací report

Načten SKILL.md přes GitHub API tree + raw; všechny tři v textu odkazované soubory (skill-writing-guide.md, quality-checklist.md, agent-authoring-guide.md) vrátily HTTP 200. Frontmatter se parsuje s name+description; žádné bezpečnostní hrozby; jedinou externí závislostí je bundles-forge audit-skill CLI, pro které skill dokumentuje manuální záložní řešení. Výstupní test: napsány dva návrhy SKILL.md pro hypotetický skill pro commit zprávy. Baseline použila název v Title-Case a popis shrnující workflow ("This skill helps you write... formats them...") – přesně anti-vzor, před kterým skill varuje – bez deklarace typu skillu, bez kroků motivovaných proč, bez sekcí Common Mistakes/Inputs/Outputs/Integration, končící holými direktivami Always/Never. Dodržení skillu vygenerovalo kebab-case název, 188-znakový popis "Use when..." pouze pro spouštění, přehled s hlavním principem + typem skillu + oznamovacím řádkem, kroky procesu, z nichž každý zdůvodňuje proč, 4řádkovou tabulku Common Mistakes a Inputs/Outputs/Integration s ID artefaktů. Konkrétní, pozorovaný rozdíl.

Testováno: 2026-07-31 · Claude Code 2.x (agent harness)

Instalace

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

Příkazy a ukázkové prompty

  • /authoringPíše a přepisuje SKILL.md a agent soubory podle konvencí projektu

Skilly se spouštějí běžnými požadavky — žádné příkazy k zapamatování. Po instalaci ho aktivují prompty jako tyto (anglicky):

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