Authoring

Helps you write and maintain the SKILL.md and agent definition files that make up a bundle-plugin. It walks through four distinct paths: drafting new content from scratch, integrating external skills into your project, filling in scaffolded stubs, or improving existing files. The focus is on making skills discoverable and followable by agents, which means tight descriptions under 250 characters, front-loaded critical instructions in the first 5,000 tokens, and matching your project's existing conventions. It enforces the discipline that skills are the source of truth, not documentation. Use this when you're building out a skill bundle and need to maintain consistency across multiple skill files while keeping token budgets reasonable.

GitHub stars: 297
last updated: Apr 27, 2026

View on GitHub

Install

$ npx -y skills add odradekai/bundles-forge --skill authoring --agent claude-code

Installs into .claude/skills of the current project.

Files

Authoring Skill Content

Overview

Guide the authoring of effective SKILL.md files, agent definitions (agents/*.md), and supporting resources within a bundle-plugin. Good content is the difference between skills that agents consistently find and follow — and ones that get ignored or misinterpreted.

Core principle: Write for the agent's experience. Every instruction should be discoverable (good description), loadable (right size), and followable (clear, motivated instructions). Skills are the first-class source of truth in a bundle-plugin — docs and README must not contradict skill content (see bundles-forge:auditing — references/source-of-truth-policy.md).

Skill type: Hybrid — follow the execution flow rigidly (Entry Detection → Path steps → Validation), but apply writing guidance flexibly based on context. The process is discipline-enforcing; the content decisions are pattern-based.

Announce at start: "I'm using the authoring skill to help [write / complete / improve / adapt] [skill / agent] content."