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

#SkillCommandModelPurpose
1agents/brewcode:agentsopusCreates, improves, syncs Claude Code subagents
2convention/brewcode:conventionopusExtracts etalon classes, patterns, architecture into convention docs
3e2e/brewcode:e2eopusOrchestrates e2e testing: BDD scenarios, Playwright autotests
4rules/brewcode:rulessonnetSyncs KNOWLEDGE.jsonl or session learnings to project rules
5skills/brewcode:skillsopusLists, improves, creates, syncs Claude Code skills
6spec/brewcode:specopusCreates SPEC.md task spec via research + interaction
7superreview/brewcode:superreviewopusGenerates a project-tailored deep-review skill: domain-expert routing + scope discipline + mechanical gates + adversarial validation
8teams/brewcode:teamsopusCreates and manages dynamic teams of domain agents
β˜…superreview (emitted)/superreviewopusPer-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:

FieldContent
GOALthe overall task and why it exists β€” the point beyond the file edit
ROLEwhat this agent owns; what it must NOT touch
SCOPEexact paths/commands in bounds + explicit out-of-bounds
CONTEXTwhat is already done, by whom, what runs in parallel β€” trimmed to what THIS agent needs
CONSUMERwho or what uses the result next, and the shape it must fit
DONEacceptance 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:

  1. Spec

    Create specification through research and user interaction. spec

  2. Superreview

    Generate a per-project deep-review skill tailored to your tech stack and agents. superreview

  3. Rules

    Sync learned knowledge to project rules for future sessions. rules

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

Use /brewtools:plugin-update to check and update the brewcode plugin suite in one command. See the FAQ for details.