Open Source

BB-Skills

AI coding skills enriched with customer evidence. Install into your favorite AI coding agent — Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, or Amazon Q. Free and open source.

BB-Skills install output in terminal

Quick Start

Install the CLI, then install the packs you need. Two commands.

Install with:

>_terminal
#Install the CLI
$pip install bb-skills
#Install skill packs
$bb-skills install spec-workflow
$bb-skills install testing
#Optional: connect BuildBetter for customer evidence
$bb-skills configure

Free forever,
better with BuildBetter

Every skill works without a BuildBetter account.

Runto enrich your workflow with real customer evidence.

Free

With BuildBetter

All skills and packs

Available
Available with BuildBetter

Works in 7 AI coding agents

Available
Available with BuildBetter

Spec-driven development workflow

Available
Available with BuildBetter

Playwright test generation

Available
Available with BuildBetter

Customer evidence in specs

Not available
Available with BuildBetter

Feature requests pulled into plans

Not available
Available with BuildBetter

Pain points surfaced in reviews

Not available
Available with BuildBetter

Customer signals in task priorities

Not available
Available with BuildBetter

Works everywhere

One install, every major AI coding agent.

Claude Code logo

Claude Code

SKILL.md

Slash commands
Codex CLI logo

Codex CLI

SKILL.md

Slash commands
Gemini CLI logo

Gemini CLI

.toml

Slash commands
Cursor logo

Cursor

.mdc rules

GitHub Copilot logo

GitHub Copilot

.instructions.md

Windsurf logo

Windsurf

.md rules

Amazon Q logo

Amazon Q

.md rules

Skill Packs

Install only the packs that matter for your workflow.

Spec Workflow

Spec-driven development enriched with real customer evidence. Define requirements, plan implementation, generate tasks, review code, and ship — all grounded in what your customers actually need.

Install with:

/bb-specify

Pulls real customer quotes and pain points from your BuildBetter knowledge base into your spec. You're not guessing what to build — you're building what customers asked for.

/bb-plan

Carries customer evidence through to your implementation plan — every design decision traces back to what customers actually said.

/bb-tasks

Generates an actionable task list from your plan, maintaining the evidence chain from customer feedback through to individual work items.

/bb-implement

Executes your task list in dependency order, checks off what's done, and keeps going until the feature is built according to the plan.

/bb-review

Runs a BuildBetter-first review of your feature. Checks usability against what customers asked for, reviews code quality, or both. Not just 'does it compile' — 'does it solve the problem customers described?'

/bb-clarify

Reads your spec and asks up to 5 targeted questions about the gaps — the stuff you forgot to define that would bite you mid-build. Answers get written back into the spec.

/bb-analyze

Consistency check across your spec, plan, and tasks. Catches when tasks don't match the plan, the plan contradicts the spec, or requirements fell through the cracks.

/bb-checklist

Generates a custom quality checklist based on your actual requirements — not a generic 'did you write tests' list, but specific checks tied to what you're building.

/bb-constitution

Sets up your project's governing principles — the rules your team agrees on that every feature should follow. All other skills reference it.

Better with BuildBetter

With a BuildBetter API key, /bb-specify pulls real customer quotes and pain points directly into your specs. Every downstream skill carries that evidence through — plans, tasks, reviews, and checklists all trace back to what customers actually said.

Testing

Browser-based verification and automated test generation. Your agent opens a real browser, walks through your app like a user, and generates Playwright tests from what it sees — not from reading your code.

Install with:

/trust-but-verify

The game changer. After you build a feature, your agent opens a real browser, walks through it like a user, and tells you if the UI/UX actually makes sense. Screenshots, responsive checks, edge cases. Like a QA + UX review in 2 minutes from your terminal.

/app-navigator

Maps your entire app — every route, page, component, and interaction pattern. Run it once and your agent knows how to navigate your app like a human would. Powers trust-but-verify and generate-tests.

/generate-tests

Turns everything the agent learned from actually using your app into Playwright test files for CI. Not tests generated from reading your code — tests generated from clicking through your app.

Better with BuildBetter

Verification checks can reference customer expectations and acceptance criteria from BuildBetter signals — so you're not just testing if it works, but if it solves what customers described.

Core

Essential utilities that keep your skills up to date.

Install with:

/bb-skills-update

Checks if there's a newer version of BB-Skills and walks you through upgrading. Auto-included with every install.

CLI Reference

bb-skills install <pack>

Install a skill pack

bb-skills uninstall <pack>

Remove an installed skill pack

bb-skills update

Update all installed packs to latest

bb-skills configure

Connect your BuildBetter account for customer evidence

bb-skills list

List installed packs and skills

bb-skills platforms

Show supported platforms and install paths

Start building with
customer evidence

Free and open source. Install in 30 seconds.

BB-Skills — AI Coding Skills | BuildBetter | BuildBetter