Update to BuildBetter.ai

{
  "description": "Use when working with BuildBetter's MCP server, bb CLI, Codex hooks, product-signal context, or preparing the BuildBetter Codex plugin for local sharing or submission.",
  "included_files": [],
  "name": "buildbetter",
  "skill_md_contents": "---\nname: buildbetter\ndescription: Use when working with BuildBetter's MCP server, bb CLI, Codex hooks, product-signal context, or preparing the BuildBetter Codex plugin for local sharing or submission.\n---\n\n# BuildBetter\n\nFor customer feedback, imported support conversations, surveys, analytics context, recordings, signals, and Knowledge, use `$buildbetter-start` to choose a focused workflow. Source coverage depends on connected data and permissions.\n\nUse this skill when the user asks Codex to use BuildBetter product context, verify the local `bb` CLI, install BuildBetter Codex hooks, or prepare/share the BuildBetter plugin.\n\n## MCP\n\nThe plugin bundles the production BuildBetter MCP server:\n\n```text\nhttps://mcp.buildbetter.app\n```\n\nThe MCP server uses OAuth and requires a BuildBetter account with an organization. If MCP authentication is not complete, ask the user to connect the BuildBetter MCP server from the Codex plugin/auth flow before attempting MCP-backed work.\n\nFor staging-only testing, use the BuildBetter app repo docs at `docs/instructions/mcp-setup.md` and the staging server URL:\n\n```text\nhttps://mcp-staging.buildbetter.app\n```\n\n## bb CLI\n\nPrefer the installed `bb` binary when it exists:\n\n```bash\ncommand -v bb\nbb --version\nbb auth status\nbb doctor\n```\n\nIf `bb` is missing or stale, follow the CLI installation instructions in the BuildBetter documentation at https://docs.buildbetter.ai/. Local CLI setup applies only to coding environments that provide a terminal; never require it for ChatGPT evidence workflows.\n\n## Hooks\n\nTo install BuildBetter end-of-turn hooks for a repo:\n\n```bash\nbb hooks install --agent codex\nbb hooks doctor --agent codex\n```\n\nUse `bb hooks repair --agent codex` when the hook exists but doctor reports drift. Use `bb hooks uninstall --agent codex` only when the user wants the BuildBetter-managed hook removed.\n\n## Feedback\n\nTo send agent feedback to BuildBetter:\n\n```bash\nbb feedback --agent --provider codex --message \"Feedback text\"\n```\n\nUse `--dry-run --json` before sending when the user wants to inspect the payload.\n\n## Plugin Distribution\n\nCodex install flow:\n\n```bash\ncodex plugin marketplace add buildbetter-app/skills --ref main --sparse .agents/plugins --sparse plugins/skills --sparse plugins/buildbetter-codex\ncodex plugin add buildbetter@buildbetter\n```\n\nWorkspace sharing flow:\n\n1. Open Plugins in the Codex app.\n2. Open Created by you.\n3. Open BuildBetter.\n4. Select Share.\n5. Add workspace members or copy the share link.\n\nThe public plugin directory serves ChatGPT and Codex. Maintainers can upload a validated plugin ZIP at https://platform.openai.com/plugins. Metadata and bundled-skill changes require a new package version; hosted MCP changes are scanned separately. Keep reviewer credentials out of public packages.\n"
}