BuildBetter Skills — скиллы со словом клиента

BuildBetter Skills

Пакеты скиллов для Claude Code, Codex и Cursor: спецификации, планы и проверка в браузере с данными клиентов BuildBetter

  • 24 ★ репозитория
  • Последний коммит
СкиллОфициальный

Расширенный доступ

Почему такой уровень

  • Скиллы браузерного тестирования ходят по запущенному приложению через Playwright MCP и могут менять его данные
  • BUILDBETTER_API_KEY открывает скиллам данные ваших клиентов в BuildBetter
Все причины и проверки

buildbetter-app/skills

Установка

В терминале, через SkillFoxx CLI

npx skillfoxx add skills/buildbetter-skills

Определит агенты на машине, покажет уровень доступа и зафиксирует версию.

Другие способы установки

Доступ и проверки

Как мы проверяем

Расширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.

  • Скиллы браузерного тестирования ходят по запущенному приложению через Playwright MCP и могут менять его данные
  • BUILDBETTER_API_KEY открывает скиллам данные ваших клиентов в BuildBetter

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

BuildBetter Skills собирает скиллы по пакетам и ставит только нужные. Пакет `spec-workflow` ведет разработку от спецификации: `bb-specify`, `bb-plan`, `bb-tasks`, `bb-implement`, а также `bb-clarify`, `bb-analyze`, `bb-checklist`, `bb-constitution` и `bb-review`. Пакет testing содержит `app-navigator`, который картирует маршруты и компоненты, `trust-but-verify`, проверяющий в браузере соответствие интерфейса плану, и `generate-tests`, создающий файлы тестов Playwright. Пакет `smart-tags` работает с умными тегами BuildBetter: создание, проверка и улучшение. Пакет support разбирает обращения клиентов: поиск причины, решение, сообщение. Если задана переменная BUILDBETTER_API_KEY, скиллы спецификаций подтягивают отзывы, запросы функций и жалобы клиентов в спецификацию, план и ревью. Без ключа они работают как обычно. Ставятся через npx skills add, через CLI `bb-skills` (pip) с автоопределением платформ или как плагины Codex и Claude Code. Часть пакетов подключает MCP и CLI BuildBetter. Основа скиллов спецификаций взята из github/spec-kit.

Для кого. Продуктовым командам, которые разрабатывают с Claude Code или Codex и хотят опирать спецификации на реальные отзывы клиентов из BuildBetter.

Подходит, если

  • Новая функция начинается со спецификации, и в ней нужны реальные запросы клиентов вместо догадок команды
  • Ветка готова к слиянию, и нужно проверить в браузере, что интерфейс соответствует плану
  • Для приложения нужны файлы тестов Playwright на основе карты маршрутов
  • Обращение клиента надо разобрать с доказательствами и подготовить ответ
  • Умный тег BuildBetter требует оценки и пакетного заполнения на истории звонков

Не подходит, если

  • Нужен только общий метод спецификаций без данных клиентов: проще взять исходный Spec Kit
  • Проект не использует BuildBetter: часть пакетов опирается на его MCP и CLI
  • Нужна проверка только серверной логики: `trust-but-verify` проверяет интерфейс в браузере, а правки без фронтенда ей не подходят

Пример запроса к агенту

/`bb-specify` личный кабинет с лентой активности, используй отзывы клиентов из BuildBetter

Ограничения

Скиллы адаптируются под платформу: Claude Code и Codex получают SKILL.md с командами через слеш, Cursor, Copilot, Windsurf и Amazon Q получают пассивные правила без команд. Данные клиентов подтягиваются только при заданном BUILDBETTER_API_KEY и вспомогательно: нет ключа или недоступен API, работа идет дальше.

Установка через pip ставит CLI `bb-skills`, пакет Codex подключает Playwright MCP для скиллов браузерного тестирования. Плагины BuildBetter для Codex и Claude Code вынесены в отдельные пакеты. Условия доступа к платформе BuildBetter в репозитории не описаны.

Как отключить. Удалите скиллы командой `bb-skills` uninstall <пакет>, а скиллы, установленные через npx, уберите из папки скиллов агента, например ~/.claude/skills/. Переменную BUILDBETTER_API_KEY уберите из окружения.

Частые вопросы

Как поставить BuildBetter Skills в Claude Code?

Выполните npx skills add buildbetter-app/skills, либо поставьте пакет через CLI: pip install `bb-skills` и `bb-skills` install `spec-workflow`. Для плагина BuildBetter есть claude plugin marketplace add buildbetter-app/skills.

Нужен ли ключ BuildBetter?

Нет. Без BUILDBETTER_API_KEY скиллы работают как обычные, с ключом они добавляют данные клиентов в спецификации, планы и ревью.

Какие пакеты есть?

core, `spec-workflow`, testing, `smart-tags` и support. Установите один командой `bb-skills` install <пакет>, все сразу через `bb-skills` install all.

Какие платформы поддерживаются?

Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf и Amazon Q. `bb-skills` platforms покажет, что найдено на машине.

Чем он отличается от Spec Kit?

Основа спецификаций взята из github/spec-kit. BuildBetter добавил данные клиентов, браузерное тестирование, поддержку нескольких платформ и менеджер скиллов.

Обсуждение

Вопросов и отзывов пока нет.

Скиллы

Навыки Spec Kit для Claude Code, Codex, Cursor, Copilot и OpenCode: спецификация, план, задачи, реализация и база по готовому коду

СкиллМинимальный доступ172Звезды репозитория

Библиотека скиллов для Claude Code, Cursor и Codex: ревью командой агентов, TDD, стековые PR, оценка готовности репозитория

ПлагинРасширенный доступ71Звезды репозитория

Два скилла для разработки от спецификации: /spec задает вопросы и сохраняет документ в specs/, /spec-impl реализует утвержденную спецификацию по шагам

СкиллРасширенный доступ387Звезды репозитория

speq ведет разработку по спецификациям в Claude Code и Codex: миссия, план, реализация и запись в постоянную библиотеку.

ПлагинРасширенный доступ54Звезды репозитория

61 небольшой скилл для Codex по 13 областям: разбор кодовой базы, тесты, миграции, безопасность, CI и ревью pull request

СкиллМинимальный доступ169Звезды репозитория

bigpowers ставит агенту 80 скиллов с шестифазным циклом разработки, воротами качества и спецификациями в папке specs

СкиллРасширенный доступ292Звезды репозитория

Сравнение с похожими

Карточки с тем же главным запросом: чем они отличаются.

ИнструментОфициальныйЗвезды репозиторияГлавное отличие
BuildBetter Skills — скиллы со словом клиента (эта карточка)да24
Spec Kitнет149 434исходный набор для спецификаций, а здесь он дополнен данными клиентов, браузерной проверкой и менеджером скиллов
BMad Methodнет55 288большой агентный процесс с ролями, тогда как BuildBetter Skills дает отдельные установочные пакеты и подтягивает данные клиентов

Коротко о README

README объясняет три способа установки, автоопределение платформ, пакеты со списком скиллов, таблицу форматов под каждую платформу, интеграцию с данными клиентов и команды CLI `bb-skills`. Лицензия указана как MIT.

Бейдж для README

Исходный SKILL.md

---
name: trust-but-verify
description: Use when a feature branch has been implemented and you need to verify the UI/UX and functionality match the original plan before merging
allowed-tools: Bash, Read, Write, Glob, Grep, Agent, mcp__playwright__*
---

# Trust But Verify

Verify that a feature implementation actually matches its plan by testing it in a real browser.

**Core principle:** Plans describe intent. Code describes implementation. Only the browser shows reality. This skill bridges all three — reading the plan, analyzing the diff, and verifying the result in a live browser.

## When to Use

- After completing a feature branch and before merging
- When a plan exists in `docs/plans/` for the current work
- When the diff touches frontend source files (UI changes)
- When you want confidence that the UI matches the spec
- When recommended by `superpowers:finishing-a-development-branch`

**Not for:** Backend-only changes, API-only work, or branches without a plan.

## Process

```dot
digraph trust_but_verify {
    "Phase 1:\nGather Context\n(subagent)" [shape=box];
    "Phase 2:\nPreflight Check\n(main)" [shape=box];
    "Phase 3:\nBrowser Verification\n(main + MCP)" [shape=box];
    "Phase 4:\nReport\n(subagent)" [shape=box];
    "Print summary\n+ link to report" [shape=doublecircle];

    "Phase 1:\nGather Context\n(subagent)" -> "Phase 2:\nPreflight Check\n(main)";
    "Phase 2:\nPreflight Check\n(main)" -> "Phase 3:\nBrowser Verification\n(main + MCP)";
    "Phase 3:\nBrowser Verification\n(main + MCP)" -> "Phase 4:\nReport\n(subagent)";
    "Phase 4:\nReport\n(subagent)" -> "Print summary\n+ link to report";
}
```

### Phase 0: Check for App Navigator

Before starting, check if `~/.claude/skills/app-navigator/app-map.md` exists.

**If it does NOT exist:**
> "I notice the app hasn't been mapped yet. Running `/app-navigator setup` first will map all your routes, build login playbooks, and document UI patterns — which makes verification much faster and more accurate.

Сообщить о проблеме