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

bubbletea-code-review — скилл для Claude Code

Скилл bubbletea-code-review для Claude Code проверяет Go-код BubbleTea-проектов: архитектуру Elm, цикл Update и стили Lipgloss.

Apache-2.0 270 установок ★ 89 обновлён 2026-09-15

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

Что делает bubbletea-code-review

Скилл анализирует TUI на charmbracelet/bubbletea: проверяет модель, обработку сообщений, Init, Update и View. Он ищет мутацию состояния, пропущенный WindowSizeMsg, ошибки в выходе через tea.Quit, проблемы с дочерними компонентами и неверное использование Bubbles и Huh.

Отдельный блок посвящён стилям Lipgloss и привязкам клавиш через key.Matches и help.KeyMap. Перед замечаниями о tea.Cmd, value receiver или вложенном Update скилл учитывает корректные паттерны BubbleTea, а критичные и серьёзные находки требует подтвердить путём файла и строкой либо фрагментом кода.

Вызов os.ReadFile(), http.Get() или time.Sleep() внутри Update() блокирует UI, поэтому такой код скилл отделяет от функций, которые лишь возвращают tea.Cmd. Для установки нужен npx или gh в зависимости от платформы.

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

  • проверить архитектуру Elm в TUI
  • найти блокирующий ввод-вывод внутри Update()
  • проверить неизменяемость состояния модели
  • оценить обработку изменения размера окна
  • найти ошибки в стилях Lipgloss и компонентах Bubbles

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

  • Проверь этот BubbleTea-код: найди блокирующий ввод-вывод и укажи файл и строку для каждого серьёзного замечания.
  • Проведи ревью Update() и View() в internal/tui/model.go по архитектуре Elm и стилям Lipgloss.
  • Проверь, правильно ли подключены дочерние компоненты Bubbles и форма Huh в этом TUI.

Как установить bubbletea-code-review

1Через Skills CLI (Vercel)

npx skills add existential-birds/beagle --skill bubbletea-code-review -a claude-code

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

~/.claude/skills/bubbletea-code-review/SKILL.md

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

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

Вопросы о bubbletea-code-review

Как установить bubbletea-code-review в Claude Code?

Выполните npx skills add existential-birds/beagle --skill bubbletea-code-review -a claude-code, затем проверьте файл ~/.claude/skills/bubbletea-code-review/SKILL.md.

Что делает bubbletea-code-review?

Скилл ревьюит BubbleTea TUI на соответствие архитектуре Elm, корректность Model/Update/View, работу команд и оформление через Lipgloss.

Какие ошибки в Update() он считает блокирующими?

Он проверяет прямые вызовы os.ReadFile(), http.Get(), time.Sleep(), блокирующее чтение из канала и huh.Form.Run() внутри Update(). Функции, которые только возвращают tea.Cmd, блокирующими находками не считаются.

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

SKILL.md · Apache-2.0
---
name: bubbletea-code-review
description: Reviews BubbleTea TUI code for proper Elm architecture, model/update/view patterns, and Lipgloss styling. Use when reviewing terminal UI code using charmbracelet/bubbletea.
---

# BubbleTea Code Review

## Hard gates (sequence)

Advance only when each **pass condition** is objectively true (reduces false positives on `tea.Cmd` and unsubstantiated blocking claims):

| Gate | Pass condition |
|------|----------------|
| **G1 — Anti–false-positive** | You skimmed **NOT Issues** below **or** read [references/elm-architecture.md](references/elm-architecture.md) **before** recording a finding about `tea.Cmd` returns, value receivers on `Update`, or nested child `Update`. |
| **G2 — Evidence for blocking / suspicious I/O** | Each Critical/Major finding names **file path + line** (or a short quoted snippet) showing the blocking call, `huh.Form.Run` in the wrong place, or other asserted anti-pattern—not a hypothetical. |
| **G3 — Verification** | Before publishing review output, you applied the **[review-verification-protocol](../review-verification-protocol/SKILL.md)** to each proposed finding. |

## Quick Reference

| Issue Type | Reference |
|------------|-----------|
| Elm architecture, tea.Cmd as data | [references/elm-architecture.md](references/elm-architecture.md) |
| Model state, message handling | [references/model-update.md](references/model-update.md) |
| View rendering, Lipgloss styling | [references/view-styling.md](references/view-styling.md) |
| Component composition, Huh forms | [references/composition.md](references/composition.md) |
| Bubbles components (list, table, etc.) | [references/bubbles-components.md](references/bubbles-components.md) |

## CRITICAL: Avoid False Positives

**Read [elm-architecture.md](references/elm-architecture.md) first!** The most common review mistake is flagging correct patterns as bugs.

### NOT Issues (Do NOT Flag These)

| Pattern | Why It's Correct |
|---------|------------------|
| `return m, m.loadData()` | `tea.Cmd` is returned immediately; runtime executes async |
| Value receiver on `Update()` | Standard BubbleTea pattern; model returned by value |
| Nested `m.child, cmd = m.child.Update(msg)` | Normal component composition |
| Helper functions returning `tea.Cmd` | Creates command descriptor, no I/O in Update |
| `tea.Batch(cmd1, cmd2)` | Commands execute concurrently by runtime |

### ACTUAL Issues (DO Flag These)

| Pattern | Why It's Wrong |
|---------|----------------|
| `os.ReadFile()` in Update | Blocks UI thread |
| `http.Get()` in Update | Network I/O blocks |
| `time.Sleep()` in Update | Freezes UI |
| `<-channel` in Update (blocking) | May block indefinitely |
| `huh.Form.Run()` in Update | Blocking call |

## Review Checklist

### Architecture
- [ ] **No blocking I/O in Update()** (file, network, sleep)
- [ ] Helper functions returning `tea.Cmd` are NOT flagged as blocking
- [ ] Commands used for all async operations

### Model & Update
- [ ] Model is immutable (Update returns new model, not mutates)
- [ ] Init returns proper initial command (or nil)
- [ ] Update handles all expected message types
- [ ] WindowSizeMsg handled for responsive layout
- [ ] tea.Batch used for multiple commands
- [ ] tea.Quit used correctly for exit

### View & Styling
- [ ] View is a pure function (no side effects)
- [ ] Lipgloss styles defined once, not in View
- [ ] Key bindings use key.Matches with help.KeyMap

### Components
- [ ] Sub-component updates propagated correctly
- [ ] Bubbles components initialized with dimensions
- [ ] Huh forms embedded via Update loop (not Run())

## Critical Patterns

### Model Must Be Immutable

```go
// BAD - mutates model
func (m Model) Update(msg tea.Msg) (tea.Model, tea.Cmd) {
    m.items = append(m.items, newItem)  // mutation!
    return m, nil
}

// GOOD - returns new model
func (m Model) Update(msg tea.Msg) (tea.Model, tea.Cmd) {
    newItems := make([]Item, len(m.items)+1)
    copy(newItems, m.items)
    newItems[len(m.items)] = newItem
    m.items = newItems
    return m, nil
}
```

### Commands for Async/IO

```go
// BAD - blocking in Update
func (m Model) Update(msg tea.Msg) (tea.Model, tea.Cmd) {
    data, _ := os.ReadFile("config.json")  // blocks UI!
    m.config = parse(data)
    return m, nil
}

// GOOD - use commands
func (m Model) Update(msg tea.Msg) (tea.Model, tea.Cmd) {
    return m, loadConfigCmd()
}

func loadConfigCmd() tea.Cmd {
    return func() tea.Msg {
        data, err := os.ReadFile("config.json")
        if err != nil {
            return errMsg{err}
        }
        return configLoadedMsg{parse(data)}
    }
}
```

### Styles Defined Once

```go
// BAD - creates new style each render
func (m Model) View() string {
    style := lipgloss.NewStyle().Bold(true).Foreground(lipgloss.Color("205"))
    return style.Render("Hello")
}

// GOOD - define styles at package level or in model
var titleStyle = lipgloss.NewStyle().Bold(true).Foreground(lipgloss.Color("205"))

func (m Model) View() string {
    return titleStyle.Render("Hello")
}
```

## When to Load References

- **First time reviewing BubbleTea** → [elm-architecture.md](references/elm-architecture.md) (prevents false positives)
- Reviewing Update function logic → [model-update.md](references/model-update.md)
- Reviewing View function, styling → [view-styling.md](references/view-styling.md)
- Reviewing component hierarchy → [composition.md](references/composition.md)
- Using Bubbles components → [bubbles-components.md](references/bubbles-components.md)

## Review Questions

1. Is Update() free of blocking I/O? (NOT: "is the cmd helper blocking?")
2. Is the model immutable in Update?
3. Are Lipgloss styles defined once, not in View?
4. Is WindowSizeMsg handled for resizing?
5. Are key bindings documented with help.KeyMap?
6. Are Bubbles components sized correctly?

© existential-birds · Apache-2.0 · existential-birds/beagle

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

Все скиллы по теме «Код-ревью и рефакторинг» →
bubbletea GGPrompts Помогает проектировать консольные интерфейсы на Go с Bubbletea и Lipgloss. Помогает собирать панели и списки, отлаживать искажения разметки. CX Codex +1 512установок review mag123c Скилл review запускает проверку кода Rust CLI/TUI с отдельными чек-листами для Rust, терминального интерфейса и clippy. UX-агент не запускается. CX Codex +1 ★ 196звёзд репо go-code-review cxuu Скилл go-code-review проверяет Go-код по общепринятым стандартам стиля и выдаёт замечания по severity. Пригодится перед отправкой PR. CX Codex +1 1 800установок encore-go-code-review encoredev Скилл encore-go-code-review проверяет Go-код на Encore: инфраструктура внутри функций, забытый context, SQL-инъекции и другие анти-паттерны перед мержем. CX Codex +1 609установок hunk-review modem-dev Скилл hunk-review для Claude Code управляет активной сессией diff-просмотрщика Hunk через CLI. Подключается, когда запущен терминальный или веб-интерфейс Hunk для интерактивного код-ревью. CX Codex +1 2 700установок go-concurrency-review eduardo-sl Скилл go-concurrency-review для Claude Code проверяет конкурентный код на Go и помогает реализовать безопасные шаблоны. Запускается при ревью горутин, поиске гонок данных и проектировании конвейеров. CX Codex +1 ★ 90звёзд репо

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

Весь набор →
react-flow-code-review Скилл react-flow-code-review для Claude Code и Codex проверяет код на @xyflow/react по чек-листу: антипаттерны, лишние ре-рендеры, типы. Фиксирует тормоза графа и пересоздание нод. CX Codex +1 329установок langgraph-architecture Скилл langgraph-architecture для Claude Code помогает выбрать структуру LangGraph-приложения, схему состояния и подход к хранению данных. Сравнивает LangGraph с альтернативами и помогает проектировать системы агентов. CX Codex +1 283установок swiftui-code-review Скилл swiftui-code-review для Claude Code проверяет SwiftUI-код: композицию представлений, состояние, производительность и доступность. Разбирает файлы с @State, @Binding, @Observable и UI-кодом. CX Codex +1 277установок tutorial-docs Скилл tutorial-docs для Claude Code задаёт структуру обучающих руководств по методологии Diataxis. Агент подключает его при написании вводных уроков и пошаговых руководств для новичков. CX Codex +1 273установок zustand-state Скилл zustand-state для Claude Code помогает создавать хранилища Zustand, выбирать данные селекторами, сохранять их в localStorage и подключать devtools. CX Codex +1 261установок dagre-react-flow Скилл dagre-react-flow настраивает автоматическую раскладку направленных графов в React Flow с помощью dagre. Помогает строить иерархические деревья и выравнивать узлы по направлениям. CX Codex +1 257установок adr-writing Скилл adr-writing для Claude Code, который оформляет архитектурные решения в документы ADR по шаблону MADR и проверяет их полноту по чек-листу E.C.A.D.R. Работает также в Codex, Cursor, GitHub Copilot, Gemini CLI и OpenCode. CX Codex +1 254установок swift-code-review Скилл swift-code-review для Claude Code проверяет Swift-код на ошибки конкурентности, обработки ошибок и управления памятью. Подключается при ревью файлов .swift, в том числе с async/await, actors и Sendable. CX Codex +1 253установок

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

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