К основному содержанию
скилл CX Codex

app-brief — скилл для Claude Code: что делает и как установить

Скилл app-brief для Claude Code и Cursor создаёт одностраничный файл docs/BRIEF.md для нового приложения под macOS до написания кода.

MIT 1 000 установок ★ 1 933 обновлён 2026-11-05

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add daveebbelaar/bama --skill app-brief -a claude-code
Открыть на GitHub

Что делает app-brief

Скилл запускается, когда у пользователя есть идея приложения или задействованы навыки клонирования и исследования. Агент проводит интервью с пользователем, подбирает имя в формате UpperCamelCase, определяет структуру данных, форму интерфейса и объем первой версии. Если пользователь предоставляет готовую спецификацию, агент переносит её блоки в соответствующие файлы.

Результат работы записывается в каталог приложения в папке docs/ по умолчанию в ~/Developer. Скилл помогает отсечь лишний функционал вроде авторизации, командной работы или биллинга для первой версии приложения. По умолчанию проект работает в автономном режиме без подключения к интернету и сторонних серверов.

Готовый документ задаёт требования для всех последующих скиллов генерации кода и структуры. Для установки используются команды пакетного менеджера навыков.

Какие задачи решает

  • создать одностраничный бриф для нового приложения под macOS
  • провести интервью с пользователем для сбора требований
  • определить структуру данных и основные экраны приложения
  • зафиксировать ограничения первой версии программы

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

  • Собери бриф для нового приложения для учёта задач
  • Создай docs/BRIEF.md для приложения заметок
  • Запусти интервью для планирования macOS утилиты

Как установить app-brief

1Через Skills CLI (Vercel)

npx skills add daveebbelaar/bama --skill app-brief -a claude-code

2Вручную: положить файлы

~/.claude/skills/app-brief/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/app-brief/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы об app-brief

Как установить app-brief в Claude Code?

Выполните команду npx skills add daveebbelaar/bama --skill app-brief -a claude-code и проверьте файл ~/.claude/skills/app-brief/SKILL.md.

Что делает app-brief?

Скилл проводит интервью с разработчиком и формирует документ docs/BRIEF.md с описанием идеи, интерфейса и данных для нового macOS приложения до написания кода.

В каких каталогах сохраняются файлы проекта?

Документация сохраняется в папке docs/ внутри каталога приложения, который по умолчанию создается в директории ~/Developer.

Исходный текст

SKILL.md · MIT
---
name: app-brief
description: One-page brief (docs/BRIEF.md) for a new macOS app, written before any code. Use when the user has an app idea, wants to replace an app they pay for, or the research and clone skills are done.
argument-hint: "[idea in a few words]"
---

# App brief

Write `docs/BRIEF.md` in a folder named after the app
(`<parent>/<AppName>/docs/BRIEF.md`; ask for the parent folder, default
`~/Developer`). Every later skill reads it. Keep it to one page.

## 1. Name and read what exists

Pick the name first: one UpperCamelCase word (`Tasks`, `DailyLog`), not the
name of an app already in `~/Applications`, and a bundle id
`com.<yourname>.<appname>` in lowercase. The folder, the research, and the
scaffold all use it.

If `docs/research/` or `docs/screens/INDEX.md` exist, read them first.
Skip every question they already answer.

If the user gives you a spec from BAMA's `specs/` folder (a file or a
link), it already holds the brief and the stories. Copy its **Brief** block
to `docs/BRIEF.md` and its **Stories** block to `docs/STORIES.md`. Keep the
rest of the spec as `docs/SPEC.md`, so later skills read its **How it
works** and **Gotchas**. Ask only what the user wants to change, then call
the Skill tool with `new-mac-app`.

## 2. Interview

Ask a few questions at a time. If the user asked you to decide everything,
answer each question yourself from the research, write the choice in the
brief, and note "decided by the agent" next to it.

1. What do you do today, and which app or habit does it replace?
2. What are the three things you do most often? These become the main pages.
3. What data does it hold? Name the nouns: tasks, notes, recipes, invoices.
4. Is there a reference app you like? Then the `clone` skill comes next.
5. Where does it live: a window with a sidebar, a menu bar item, a
   quick-capture panel with a global shortcut, or a mix?
6. Does it need the internet? Default: no.
7. Which three things are out of scope for version one?
8. Should it look like a built-in Mac app, or have its own look? Note a
   brand or accent color, and any app they name ("like Things"): the
   `design-from-app` skill rebuilds its look. No answer means native with
   the Mac's own accent color.

## 3. Cut scope

A personal app has one user. Remove what exists only for other users:
accounts, sharing, teams, sync servers, billing, onboarding, analytics. If
the user wants data on two Macs, note "later: iCloud sync".

Version one is one afternoon of agent time: one window, two to five main
pages, one data model with two to four types. Smart lists that filter one
model (Today, Upcoming, Someday) count as one page.

## 4. Write docs/BRIEF.md

```markdown
# <AppName>

One sentence: what it is and who it is for.

## Replaces
<app or habit>

## Main jobs
1. ...
2. ...
3. ...

## Data
- <Type>: <fields>

## Shape
<sidebar window / menu bar extra / quick panel>, macOS 26 or later.
Local data. Works offline. No accounts.

## System hooks
<global shortcut, menu bar, Share menu, Shortcuts, CLI, or "none">

## Reference
<app name, or "none">

## Look
<native with an accent color (name it, or "system"), own parts, or "like <app>", and why>

## Not in version one
- ...
```

## 5. Hand off

Call the Skill tool with `user-stories`, or with `new-mac-app` if the user
wants to see a window first.

Done when `docs/BRIEF.md` exists, fits on one page, and has every section.

© daveebbelaar · MIT · daveebbelaar/bama

Похожие скиллы

Все скиллы по теме «Тексты и документация» →
brief Alireza Rezvani Скилл brief превращает вопрос или заметки со встречи в одностраничный бриф с опциями, допущениями и критериями успеха. Ставят перед обсуждением решения. CX Codex +1 386установок monday-brief ilyautov Скилл monday-brief собирает утренний бриф понедельника по финансам, продажам и CRM на один экран за две минуты. CX Codex +1 ★ 38звёзд репо apple-notes openclaw Управляет Apple Notes через утилиту memo в терминале. Ищет, создаёт и экспортирует заметки в Markdown. CX Codex +1 6 000установок bmad-product-brief bmad-code-org Скилл bmad-product-brief для Claude Code, структурирующий создание, редактирование и проверку product brief-документов через диалог, а не шаблон. CX Codex +1 14 500установок flows-app-brief cognitedata Скилл flows-app-brief для Claude Code и Codex помогает составить бриф приложения Flows. Задаёт вопросы разработчику, проверяет размытые ответы и сохраняет готовый App-Brief.md в корне репозитория. CX Codex +1 1 100установок 06-product-brief AI-Driven Dev Скилл 06-product-brief формирует лаконичный продуктовый бриф до перехода к требованиям. Помогает описать гипотезу продукта и стратегию её проверки. CX Codex +1 ★ 571звёзд репо

Из того же набора21

Весь набор →
agent-cli Скилл agent-cli для Claude Code, Codex и Cursor добавляет командную строку и MCP-сервер к macOS-приложению, чтобы ИИ управлял им через локальный сокет. CX Codex +1 1 000установок build-and-verify Скилл build-and-verify для Claude Code собирает SwiftUI-приложение для macOS и проверяет снимки страниц в двух темах. Агент запускает его после изменений интерфейса, ошибок сборки или просьбы проверить приложение. CX Codex +1 1 000установок performance Скилл performance для Claude Code, который измеряет нагрузку на CPU, память и энергию в macOS-приложениях. Помогает находить причины зависаний и переносить вычисления с основного потока на GPU. CX Codex +1 1 000установок improve-architecture Скилл improve-architecture для Claude Code разбирает архитектуру macOS-приложения на Swift и планирует безопасный рефакторинг. Срабатывает перед крупной функцией, в конце этапа или при повторяющихся проблемах в одной области. CX Codex +1 1 000установок design-from-app Скилл design-from-app для Claude Code воссоздает дизайн любого приложения в виде нативной дизайн-системы SwiftUI по скриншотам. CX Codex +1 1 000установок os-integrations Скилл os-integrations для Claude Code помогает выбрать API macOS и нужные разрешения для системных функций приложения. Включается при добавлении глобальных горячих клавиш, захвата экрана или управления окнами других приложений. CX Codex +1 1 000установок layout-grid Скилл layout-grid для Claude Code проверяет сетку и выравнивание в приложениях macOS SwiftUI. Запускается при создании кастомных экранов, карточек, форм и после изменения вёрстки. CX Codex +1 1 000установок user-stories Скилл user-stories для Claude Code, который превращает описание приложения в бэклог пользовательских историй с проверяемыми критериями. CX Codex +1 1 000установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой