Authoring

Skriver og omskriver SKILL.md og agentfiler til prosjektkonvensjoner

av OdradekAI · OdradekAI/bundles-forge

Bestått ★ 8.8/10

Authoring — Skriver og omskriver SKILL.md og agentfiler til prosjektkonvensjoner

Hva den gjør

Veileder skriving, fullføring, integrering eller forbedring av SKILL.md og agents/*.md-innhold i en bundle-plugin, med fire eksplisitte stier (new, integrate, complete, improve) pluss konvensjoner for beskrivelser, kroppsstruktur og tokenbudsjett. Utløses ved forfatting eller omskriving av ferdighets-/agentdefinisjoner, utfylling av stillas-stumper, tilpasning av eksterne ferdigheter, eller fiksing av beskrivelser som ikke utløses pålitelig. Validering kjører bundles-forge audit-skill CLI med en dokumentert manuell sjekkliste som tilbakefall.

Testrapport

Hentet SKILL.md via GitHub API-treet + rå; alle tre kroppsrefererte filer (skill-writing-guide.md, quality-checklist.md, agent-authoring-guide.md) returnerte HTTP 200. Frontmatter parses med name+description; ingen sikkerhetsbrudd; eneste eksterne avhengighet er bundles-forge audit-skill CLI, som ferdigheten dokumenterer et manuelt tilbakefall for. Utdata-test: skrev to SKILL.md-utkast for en hypotetisk commit-melding-ferdighet. Baseline brukte et Title-Case-navn og en arbeidsflyt-sammendragsbeskrivelse ("This skill helps you write... formats them...") – nøyaktig anti-mønsteret ferdigheten advarer mot – uten ferdighetstype-deklarasjon, ingen hvorfor-motiverte trinn, ingen Common Mistakes/Inputs/Outputs/Integration-seksjoner, og endte i bare Always/Never-direktiver. Ved å følge ferdigheten ble det produsert et kebab-case-navn, en 188-tegns "Use when..." utløsende-kun-beskrivelse, en oversikt med kjerneprinsipp + ferdighetstype + annonseringslinje, prosesstrinn som hver begrunnet hvorfor, en 4-rads Common Mistakes-tabell, og Inputs/Outputs/Integration med artefakt-ID-er. Konkret, observert forskjell.

Testet på: 2026-07-31 · Claude Code 2.x (agent harness)

Installer

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

Kommandoer og eksempelprompter

  • /authoringSkriver og omskriver SKILL.md og agentfiler til prosjektkonvensjoner

Skills utløses av vanlige forespørsler — ingen kommandoer å huske. Etter installasjonen aktiverer prompter som disse skillen (på engelsk):

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