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.


Quick Start
Install the CLI, then install the packs you need. Two commands.
Install with:
Free forever,
better with BuildBetter
Every skill works without a BuildBetter account.
Free
All skills and packs
Works in 7 AI coding agents
Spec-driven development workflow
Playwright test generation
Customer evidence in specs
Feature requests pulled into plans
Pain points surfaced in reviews
Customer signals in task priorities
Works everywhere
One install, every major AI coding agent.

Claude Code
SKILL.md

Codex CLI
SKILL.md

Gemini CLI
.toml

Cursor
.mdc rules

GitHub Copilot
.instructions.md

Windsurf
.md rules

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:
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.
Carries customer evidence through to your implementation plan — every design decision traces back to what customers actually said.
Generates an actionable task list from your plan, maintaining the evidence chain from customer feedback through to individual work items.
Executes your task list in dependency order, checks off what's done, and keeps going until the feature is built according to the plan.
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?'
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.
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.
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.
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:
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.
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.
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:
Checks if there's a newer version of BB-Skills and walks you through upgrading. Auto-included with every install.
CLI Reference
Install a skill pack
Remove an installed skill pack
Update all installed packs to latest
Connect your BuildBetter account for customer evidence
List installed packs and skills
Show supported platforms and install paths
Start building with
customer evidence
Free and open source. Install in 30 seconds.