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.
$ pip install bb-skills
$ bb-skills install spec-workflow
$ bb-skills install testing
$ bb-skills configure
Free forever, better with BuildBetter
Every skill works without a BuildBetter account. Run bb-skills configure to enrich your workflow with real customer evidence.
Works everywhere
One install, every major AI coding agent.
Claude Code
SKILL.md
Slash commandsCodex CLI
SKILL.md
Slash commandsCursor
.mdc rules
GitHub Copilot
.instructions.md
Gemini CLI
.toml
Slash commandsWindsurf
.md rules
Amazon Q
.md rules
Skill Packs
Install only the packs that matter for your workflow.
Spec Workflow
bb-skills install spec-workflowSpec-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.
/bb-specifyPulls 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-planCarries customer evidence through to your implementation plan — every design decision traces back to what customers actually said.
/bb-tasksGenerates an actionable task list from your plan, maintaining the evidence chain from customer feedback through to individual work items.
/bb-implementExecutes your task list in dependency order, checks off what's done, and keeps going until the feature is built according to the plan.
/bb-reviewRuns 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-clarifyReads 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-analyzeConsistency 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-checklistGenerates 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-constitutionSets up your project's governing principles — the rules your team agrees on that every feature should follow. All other skills reference it.
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
bb-skills install testingBrowser-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.
/trust-but-verifyThe 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-navigatorMaps 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-testsTurns 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.
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
bb-skills install coreEssential utilities that keep your skills up to date.
/bb-skills-updateChecks 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 packbb-skills uninstall <pack>Remove an installed skill packbb-skills updateUpdate all installed packs to latestbb-skills configureConnect your BuildBetter account for customer evidencebb-skills listList installed packs and skillsbb-skills platformsShow supported platforms and install pathsStart building with customer evidence
Free and open source. Install in 30 seconds.
pip install bb-skills