02 / bro skill system

Policy that travels.

Skills say when and why. The CLI owns how. Stop copying workflow mechanics into prompts.

Markdown policy. Executable mechanics.

Each Agent Skill lives in skills/<name>/SKILL.md. Act, debt, drill, SDD, retro — thin policy wrappers over CLI commands, not another implementation.

Explore the skills →

Hooks remember. Guard nudges.

Rehydrate on start, contribute context on prompt, check completion on stop. Hooks carry enforcement; declarative guard rules contribute scoped nudges, never their own hard gate. Hooks fail open; the CLI carries the verdict.

Packs in. Lock what you install.

@broject/bro-pack carries the default skills and formulas, installed through bro setup --pack. The skills lock records installed source provenance. Your repo can carry its own policy without forking the mechanics.

Skills and lock reference →