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

improve-loop — скилл для Claude Code: установка и функции

Скилл improve-loop для Claude Code ведёт разработку macOS-приложения по историям из docs/STORIES.md. Он собирает приложение, сравнивает снимки экранов с образцами и фиксирует готовые истории в Git.

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

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

Что делает improve-loop

Скилл берёт первую готовую к работе историю из docs/STORIES.md, переводит её в статус doing и проводит через планирование, код, сборку, проверку снимков и коммит. Истории с незакрытыми зависимостями он пропускает. Для сборки запускает ./build.sh, а снимки делает с тестовыми данными через APP_SEED=1.

Снимок и эталонное изображение сравниваются по поведению, текстам и расположению элементов. После правок скилл пересобирает приложение и повторяет сравнение, но не больше трёх раз на историю. Если расхождения остаются, история возвращается в todo с описанием блокера. Новые страницы добавляются в SidebarItem, чтобы режим снимков мог их открыть.

После завершения этапа скилл отмечает истории в docs/STORIES.md, коммитит изменения и формирует отчёт. В конце запускает ./build.sh --open. Для работы нужны проект с docs/STORIES.md и скрипт ./build.sh; скилл также следует указаниям swift-swiftui, mac-design и build-and-verify.

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

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

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

  • Продолжи работу по историям в docs/STORIES.md до конца этапа M2, затем остановись.
  • Проведи приложение по очереди историй до готовности и сравни экраны с эталонными снимками.
  • Работай с очередью историй без моего участия и сообщи, что заблокировано.

Как установить improve-loop

1Через Skills CLI (Vercel)

npx skills add daveebbelaar/bama --skill improve-loop -a claude-code

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

~/.claude/skills/improve-loop/SKILL.md

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

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

Вопросы об improve-loop

Как установить improve-loop в Claude Code?

Выполни npx skills add daveebbelaar/bama --skill improve-loop -a claude-code. Файл скилла находится по пути ~/.claude/skills/improve-loop/SKILL.md.

Что делает improve-loop?

Он последовательно реализует истории из docs/STORIES.md: собирает macOS-приложение, сверяет снимки экранов с эталонами, исправляет расхождения и коммитит результат.

Сколько раз improve-loop сравнивает снимок после исправлений?

Не больше трёх раз для одной истории. Если совпадения добиться не удалось, история возвращается в todo с заметкой о блокере.

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

SKILL.md · MIT
---
name: improve-loop
description: Autonomous loop that works through docs/STORIES.md one story at a time for a macOS app, building, snapshotting, comparing against reference screenshots, fixing, and committing, until a milestone is done. Use when the user says "keep going", "work through the backlog", "make it match the reference", or wants an unattended improvement loop.
argument-hint: "[milestone, e.g. M1]"
---

# Improve loop

One pass through the loop takes one story from `todo` to `done`:

```text
pick story -> plan -> code -> ./build.sh -> snapshot -> compare -> fix -> commit -> update STORIES.md
```

Stop after the milestone the user named, or after the current milestone if
they named none. Then report.

## 1. Pick

Open `docs/STORIES.md`. Take the first `todo` story in the current
milestone whose dependencies are `done`. Set it to `doing`.

## 2. Plan

If the story adds a screen, an action, or words and has no `UX:` block
yet, call the Skill tool with `ux-design` first.

Write two to five lines in your head or in the commit body: which files
change, which model fields are new, which menu command and shortcut it adds,
which snapshot page shows it. If the story needs a new SwiftData field, give
it a default value so existing databases keep loading.

## 3. Code

Follow the `swift-swiftui` and `mac-design` skills, the story's `UX:`
block, and `design/DESIGN-SYSTEM.md` if the app has one. System hooks follow
`os-integrations`. Keep each view file under about 300 lines.
Put new pages in the `SidebarItem` enum so snapshot mode visits them.

## 4. Build and snapshot

Follow the `build-and-verify` skill. If the story has logic, add a test
or a self-test step (`test-mac-app` skill). Use seed data (`APP_SEED=1`) so pages
show real content.

## 5. Compare

Open your snapshot and the story's reference screenshot side by side with
the Read tool. Write down the differences that matter, in this order:

1. Missing or wrong behavior from the acceptance criteria.
2. Words and flow: names, surface, and states that differ from the `UX:`
   block or `docs/GLOSSARY.md`.
3. Layout: wrong column, wrong order, missing element, and every FAIL from
   the grid checks.
4. Hierarchy: what is biggest, boldest, first.
5. Spacing and alignment.
6. Color and details.

The goal is the same structure and behavior, built from Apple's own controls.
It is not a pixel copy. When the reference uses a web-style custom control
and macOS has a native one (a toolbar, a sidebar, a context menu, a date
picker), use the native one.

No reference screenshot (no app was cloned)? Compare against the story's
acceptance lines and the `mac-design` rules instead.

Snapshot only the pages a story touches (`APP_SNAPSHOT_PAGES`), and the
full set at the end of each milestone.

Fix, rebuild, and compare again. Three rounds per story at most. If it still
does not match, set the story to `todo` again with a note that says what is
blocking, and move on.

## 6. Commit and record

```bash
git add -A
git commit -m "Complete tasks with Command-Return"
```

Set the story to `done` in `docs/STORIES.md` and commit that with the code.
One story per commit, so any story can be reverted on its own. M1 may
land as one commit when its stories share one skeleton (model, pages,
list, persistence); from M2 on, one story per commit.

## 7. Report

At the end of the loop, report to the user:

- Stories done, with one line each and the snapshot paths that show them.
- Stories blocked, and why.
- Anything the user should try by hand (shortcuts, drag and drop).
- The next story in line.

Then `./build.sh --open` so the user can try the new build.

## Milestone check-in

When the last story of a milestone is `done`, call the Skill tool with
`improve-architecture` before you start the next milestone. Unattended, do
its top recommendation only if it is `Strong`, and leave the rest in the
review file for the user.

When a story fixes a bug, add an entry to `docs/FIXLOG.md`: symptom,
cause, fix, and a last line `Rule: <what to always or never do>`. The fix
log outlives squashed history, and the check-in reads it.

## Running it unattended

The loop works with no one watching, because every step checks itself:
the build, the snapshots, the acceptance criteria. To let it run longer,
start it with a clear limit ("finish M2, then stop"), make sure the tree is
committed before you start, and never let it touch the user's real database.
Each story is a separate commit, so the user can review the history in the
morning and revert anything they do not like.

Done when every story in the milestone is `done` or named in the report as
blocked with a reason, each done story has its own commit, and the user
has the report.

© daveebbelaar · MIT · daveebbelaar/bama

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

Каталог скиллов SKILL.md →
improve-codebase-architecture Matt Pocock Скилл improve-codebase-architecture для Claude Code ищет архитектурные узкие места в кодовой базе и показывает варианты углубления модулей в HTML-отчёте. Отчёт содержит материал для ревью перед рефакторингом. CX Codex +1 1 163 035установок improve-animations emilkowalski Скилл improve-animations для Claude Code сканирует кодовую базу интерфейса и находит проблемы в анимациях. Он составляет готовые пошаговые планы исправлений для других моделей без прямой правки кода проекта. CX Codex +1 282 800установок improve shadcn Скилл improve анализирует кодовую базу в режиме чтения и создаёт автономные пошаговые планы для других агентов. Помогает найти баги, долги архитектуры и проблемы безопасности без правки файлов. CX Codex +1 42 400установок improve-ui ibelick Скилл improve-ui для Claude Code, который проверяет интерфейс по его собственным дизайн-правилам и находит подтверждённые расхождения. Работает только на чтение: код продукта не трогает, а пишет планы правок для другого агента. CX Codex +1 10 400установок improve-retention wondelai Скилл improve-retention для Claude Code разбирает, почему пользователи уходят после регистрации, и указывает, что чинить в онбординге. Диагностирует причины падения retention-кривой. CX Codex +1 6 000установок improve-react millionco Скилл improve-react аудирует кодовую базу React через сканер React Doctor и готовит готовые инструкции для агентов-исполнителей. Скилл работает строго в режиме чтения. CX Codex +1 2 900установок

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

Весь набор →
research Скилл research для Claude Code собирает онлайн-исследование перед разработкой macOS-приложения. Запускает параллельных субагентов для сравнения приложений, отзывов и возможностей macOS. CX Codex +1 1 000установок 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установок app-brief Скилл app-brief для Claude Code и Cursor создаёт одностраничный файл docs/BRIEF.md для нового приложения под macOS до написания кода. 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установок

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

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