Skills
Skills (recipes) are slash commands that define what to do. Each skill is described in a SKILL.md file
with frontmatter metadata and instructions for agents. Brewcode includes 8 skills covering
the full task lifecycle β from project analysis to E2E testing.
On top of those there is a dynamic ninth skill: it is not shipped with the plugin, it is generated into every target project by /brewcode:superreview and invoked there as /superreview, tailored to that projectβs tech stack, agents, rules and tracker. See the emitted skill page for details.
Summary table
| # | Skill | Command | Model | Purpose |
|---|---|---|---|---|
| 1 | agents | /brewcode:agents | opus | Creates, improves, syncs Claude Code subagents |
| 2 | convention | /brewcode:convention | opus | Extracts etalon classes, patterns, architecture into convention docs |
| 3 | e2e | /brewcode:e2e | opus | Orchestrates e2e testing: BDD scenarios, Playwright autotests |
| 4 | rules | /brewcode:rules | sonnet | Syncs KNOWLEDGE.jsonl or session learnings to project rules |
| 5 | skills | /brewcode:skills | opus | Lists, improves, creates, syncs Claude Code skills |
| 6 | spec | /brewcode:spec | opus | Creates SPEC.md task spec via research + interaction |
| 7 | superreview | /brewcode:superreview | opus | Generates a project-tailored deep-review skill: domain-expert routing + scope discipline + mechanical gates + adversarial validation |
| 8 | teams | /brewcode:teams | opus | Creates and manages dynamic teams of domain agents |
| β | superreview (emitted) | /superreview | opus | Per-project deep review β written into your repo by /brewcode:superreview |
agents
Agent creation, improvement, and sync
convention
Convention analysis and reference classes
e2e
E2E testing: scenarios, autotests, quorum review
rules
Knowledge-to-rules synchronization
skills
Skill management and sync
spec
Specification creation through research
superreview
Generate a project-tailored deep-review skill (review + standards merged)
teams
Dynamic agent teams with self-selection and tracking
superreview (emitted)
Per-project deep review with adversarial validation β written into your repo by /brewcode:superreview
Delegation β one contract, all eight skills
Every skill here fans work out to subagents, and all of them follow the same sizing rule.
Why the rule exists
A big task handed to one agent = an agent gone for an hour: you cannot observe it, cannot correct it, and it usually drifts off-target.
One subagent = ONE bounded unit: one deliverable, roughly 5 files, roughly 10 steps. Anything bigger is split into N tasks and spawned in ONE message, in parallel. That is why convention runs 10 layer agents instead of one, spec partitions research into 5-10 areas, and teams creates agents one file per spawn.
Every spawn prompt carries six fields β a bare one-line task is never enough:
| Field | Content |
|---|---|
| GOAL | the overall task and why it exists β the point beyond the file edit |
| ROLE | what this agent owns; what it must NOT touch |
| SCOPE | exact paths/commands in bounds + explicit out-of-bounds |
| CONTEXT | what is already done, by whom, what runs in parallel β trimmed to what THIS agent needs |
| CONSUMER | who or what uses the result next, and the shape it must fit |
| DONE | acceptance criteria + the exact report shape you want back |
The same brief lives in the runtime templates these skills read β the e2e mode references, conventionβs rules guide, specβs SPEC-creation reference, and superreviewβs emitted skill template β so a fan-out three levels deep still gets a full brief.
Lifecycle
The recommended skill execution order for a standard project cycle:
- Spec
Create specification through research and user interaction. spec
- Superreview
Generate a per-project deep-review skill tailored to your tech stack and agents. superreview
- Rules
Sync learned knowledge to project rules for future sessions. rules
- Teams (optional)
Create 5-20 project-specific agents with self-selection and performance tracking. teams
Skill Management
Use /brewcode:skills to list, create, improve, or sync (delete-first, non-growth). The Skill Creator agent handles the creation process.
Skill dependencies
spec --> superreview --> /superreview (emitted into your repo)
|
+-- convention (optional)
+-- rules
+-- teams (optional)
Dynamic Teams β New
/brewcode:teams creates 5-20 project-specific agents with self-selection protocol,
performance tracking, and automatic tuning. Run /brewcode:teams to build
a team adapted to your projectβs domains and architecture.
Independent Skills
These skills work standalone β no prerequisite steps required:
superreview
Generate a project-tailored deep-review skill (review + standards merged)
skills
Skill management: list, create, improve, sync
agents
Agent creation, improvement, and sync
e2e
E2E testing orchestration
Moved to Brewtools
Skills text-optimize, text-human, secrets-scan, ssh and deploy have been moved to the Brewtools plugin.
Latest Release
Download, changelog, and installation instructions.
View on GitHub
Source code, README, and configuration files.
Updating plugins
/brewtools:plugin-update to check and update the brewcode plugin suite in one command.
See the FAQ for details.