Back to Browse

Skills MCP Server

Developer ToolsLow Risk10.0MCP RegistryRemote
Free

Server data from the Official MCP Registry

Research customer feedback, calls, support, surveys and product usage with source citations.

About

Research customer feedback, calls, support, surveys and product usage with source citations.

Remote endpoints: streamable-http: https://mcp.buildbetter.app

Security Report

10.0
Low Risk10.0Low Risk

Valid MCP server (1 strong, 0 medium validity signals). No known CVEs in dependencies. Imported from the Official MCP Registry.

Endpoint verified · Requires authentication · 1 issue found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Permissions Found in Source Code

Found by scanning the linked source code. This listing connects to a hosted endpoint, so none of this runs on your machine: it describes what the server software does where it is hosted.

file_system

Applies to the server that hosts this plugin, not to your machine.

env_vars

Applies to the server that hosts this plugin, not to your machine.

Shell Command Execution

Runs commands on the server that hosts it, not on your machine.

HTTP Network Access

Connects to external APIs or services over the internet.

What You'll Need

Set these up before or after installing:

BUILDBETTER_API_KEYRequired

How to Connect

Remote Plugin

No local installation needed. Your AI client connects to the remote endpoint directly.

Add this to your MCP configuration to connect:

{
  "mcpServers": {
    "io-github-buildbetter-app-buildbetter": {
      "url": "https://mcp.buildbetter.app"
    }
  }
}

Documentation

View on GitHub

From the project's GitHub README.

BuildBetter Skills

AI coding skills enriched with BuildBetter customer evidence.


What is this?

BuildBetter Skills is a collection of AI coding skills you can install into your favorite AI coding agent. Pick the skills you need -- install only the packs that matter for your workflow. BuildBetter Skills works with Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, and Amazon Q.

Quick start

Option A: npx (fastest, no install)

npx skills add buildbetter-app/skills

Or install a specific skill:

npx skills add buildbetter-app/skills --skill trust-but-verify

Option B: bb-skills CLI (pack-based install)

pip install bb-skills
bb-skills install spec-workflow    # spec-driven development skills
bb-skills install testing          # browser testing skills
bb-skills install all              # everything

Option C: Codex plugin package

This repo also includes a Codex plugin package at plugins/skills/ plus a repo-local marketplace entry at .agents/plugins/marketplace.json. The plugin bundles the same BuildBetter Skills prompts for Codex and includes Playwright MCP wiring for the browser-testing skills.

codex plugin marketplace add buildbetter-app/skills --ref main --sparse .agents/plugins --sparse plugins/skills --sparse plugins/buildbetter-codex
codex plugin add skills@buildbetter

Option D: BuildBetter MCP/CLI plugins

This repo includes separate BuildBetter MCP/CLI plugins for Codex and Claude Code under plugins/buildbetter-codex/ and plugins/buildbetter-claude/. They include BuildBetter-specific skills for MCP routing, customer voice, synthetic research, native surveys, Smart Tags, project triage, and knowledge gaps. They are separate packages because Codex and Claude Code use different plugin manifest directories and remote MCP config schemas.

Codex:

codex plugin marketplace add buildbetter-app/skills --ref main --sparse .agents/plugins --sparse plugins/skills --sparse plugins/buildbetter-codex
codex plugin add buildbetter@buildbetter

Claude Code:

claude plugin marketplace add buildbetter-app/skills --sparse .claude-plugin plugins/buildbetter-claude
claude plugin install buildbetter@buildbetter

Option E: Grok, Cursor and MCP marketplaces

The existing Grok/Cursor plugin uses BuildBetter's production MCP and nine public research workflows. For the MCP Registry, Google Connected Apps, Meta, Microsoft 365, Salesforce and AWS preparation, see the distribution guide. Build a reproducible kit with python3 scripts/build_mcp_distribution.py. Provider registration, native-host QA and marketplace approval are separate from building the package.

3. Use them

Skills are installed into your AI coding agent. On platforms with slash commands (Claude Code, Codex, Gemini):

/bb-specify Build a user dashboard with activity feed
/bb-plan
/trust-but-verify

On passive platforms (Cursor, Copilot, Windsurf, Amazon Q), skills are injected as context automatically.

How it works

You run bb-skills install once per machine. The CLI auto-detects which AI coding platforms you have installed (~/.claude/, ~/.codex/, ~/.gemini/, .cursor/, etc.) and copies skills to all of them in the correct format.

To see what platforms are detected:

bb-skills platforms

To install for a specific platform only:

bb-skills install testing --platform claude

To install a single skill instead of a whole pack:

bb-skills install trust-but-verify

Available packs

PackSkillsDescription
corebb-skills-updateUpdate checker (auto-included)
spec-workflowbb-specify, bb-plan, bb-review, bb-tasks, bb-clarify, bb-analyze, bb-checklist, bb-constitution, bb-implementBuildBetter-enriched spec-driven development
testingapp-navigator, trust-but-verify, generate-testsBrowser-based verification and Playwright test generation
smart-tagsbuildbetter-create-smart-tag, buildbetter-backfill-smart-tag, buildbetter-review-improve-smart-tagCreate, evaluate, backfill, and improve BuildBetter Smart Tags
supportbuildbetter-customer-issue-triageEvidence-backed customer issue triage and handoff

Platform support

PlatformFormatSlash CommandsInstall Path
Claude CodeSKILL.mdYes~/.claude/skills/
Codex CLISKILL.mdYes~/.codex/skills/
Cursor.mdc rulesNo (passive).cursor/rules/
GitHub Copilot.instructions.mdNo (passive).github/instructions/
Gemini CLI.tomlYes~/.gemini/commands/bb-skills/
Windsurf.md rulesNo (passive).windsurf/rules/
Amazon Q.md rulesNo (passive).amazonq/rules/

Skill reference

core

SkillDescription
bb-skills-updateChecks for available BuildBetter Skills updates via GitHub releases

spec-workflow

SkillDescription
bb-specifyDefine what you want to build -- requirements and user stories
bb-planCreate a technical implementation plan with your chosen tech stack
bb-reviewBuildBetter-first usability and code review
bb-tasksGenerate an actionable task list from your implementation plan
bb-clarifyClarify underspecified areas before planning
bb-analyzeCross-artifact consistency and coverage analysis
bb-checklistGenerate quality checklists that validate requirements completeness
bb-constitutionCreate or update project governing principles
bb-implementExecute all tasks to build the feature according to the plan

testing

SkillDescription
app-navigatorMap application routes, pages, and components for UI/UX audit
trust-but-verifyVerify UI/UX and functionality match the original plan
generate-testsGenerate reusable Playwright test files from the app map

smart-tags

SkillDescription
buildbetter-create-smart-tagCreate or configure a Smart Tag and run a bounded evaluation
buildbetter-backfill-smart-tagPreview and run a bounded Smart Tag backfill
buildbetter-review-improve-smart-tagReview evaluation cases and run a prompt-improvement regression

support

SkillDescription
buildbetter-customer-issue-triageTriage, investigate, resolve, and communicate customer issues

BuildBetter workspaces

Synced into BuildBetter workspaces as "BuildBetter Skills".

Every BuildBetter workspace gets this repository as a GitHub Skill Set source (Mirror mode): one "BuildBetter Skills" Skill Set whose folders follow this repository. plugins/buildbetter-claude, plugins/buildbetter-grok, plugins/skills, skills/core and skills/support are left out, and bob/skills reaches only workspaces with BOB. A merge to main updates every workspace, so skill changes here need PR review.

BuildBetter integration

The spec-workflow skills can optionally use BuildBetter's customer evidence API to enrich specifications, plans, and reviews with real customer data. This is not required -- all skills work without it. When a BUILDBETTER_API_KEY environment variable is set, the workflow will automatically pull relevant customer insights, feature requests, and pain points into your specs and plans.

To enable it, set the API key in your shell:

export BUILDBETTER_API_KEY=your_key_here

Evidence collection is best-effort and never blocks the workflow. If the key is missing or the API is unreachable, skills continue normally.

Updating

To update all installed skills to the latest version:

bb-skills update

CLI reference

CommandDescription
bb-skills install <pack>Install a skill pack
bb-skills uninstall <pack>Remove an installed skill pack
bb-skills updateUpdate all installed packs to latest
bb-skills listList installed packs and skills
bb-skills platformsShow supported platforms and install paths

Contributing

See CONTRIBUTING.md for guidelines on adding skills, writing adapters, and submitting pull requests.

Acknowledgments

BuildBetter Skills was inspired by and originally derived from github/spec-kit (MIT License). BuildBetter has significantly extended the original with customer evidence integration, browser testing skills, multi-platform support, and a skill management CLI.

License

This project is licensed under the MIT License. See LICENSE for details.

Reviews

No reviews yet

Be the first to review this server!