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

wish-ssh-code-review — скилл для Claude Code: обзор и установка

Скилл wish-ssh-code-review проверяет код SSH-серверов на базе Go-библиотеки Charmbracelet Wish: порядок middleware, работу с PTY, ключи хоста и корректное завершение работы.

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

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

Что делает wish-ssh-code-review

Скилл задаёт строгую последовательность аудита для сервисов на базе charmbracelet/wish. Сначала ассистент находит точки входа вроде wish.NewServer, цепочки ssh.Handler и подключение bubbletea.Middleware. Далее собираются факты о настройке: пути к хостовым ключам, порядок промежуточных обработчиков и наличие вызовов Shutdown при перехвате сигналов ОС.

Отдельный шаг проверяет обработку терминала. Скилл заставляет модель выяснить, запрашивает ли teaHandler размеры окна через s.Pty() и задействованы ли изолированные рендеры bubbletea.MakeRenderer для стилей Lipgloss. Без проверки s.Pty() интерфейс упадёт при подключении без терминала, поэтому скилл выносит такие места в замечания вида [FILE:LINE] ISSUE_TITLE.

Проверка строго опирается на исходный код: замечания нельзя формировать по памяти, пока не пройдены все предварительные этапы ревью.

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

  • найти ошибки в порядке вызова middleware сервера Wish
  • проверить корректность graceful shutdown для активных SSH-сессий
  • выявить отсутствие проверки размеров окна терминала через PTY
  • проконтролировать безопасную загрузку хостовых SSH-ключей

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

  • Проведи ревью кода нашего SSH-сервера на базе Wish по чек-листу
  • Проверь server.go: корректно ли настроены middleware и завершение работы
  • Посмотри инициализацию BubbleTea в SSH-сессиях на предмет утечек контекста

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

1Через Skills CLI (Vercel)

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

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

~/.claude/skills/wish-ssh-code-review/SKILL.md

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

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

Вопросы о wish-ssh-code-review

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

Выполните команду npx skills add existential-birds/beagle --skill wish-ssh-code-review -a claude-code либо сохраните файл скилла по пути ~/.claude/skills/wish-ssh-code-review/SKILL.md.

Что делает wish-ssh-code-review?

Он направляет ИИ-ассистента по шагам аудита Go-кода с библиотекой charmbracelet/wish: проверяет хостовые ключи, очерёдность логов и аутентификации, таймауты соединений и изоляцию сессий BubbleTea.

В каком формате скилл выдаёт замечания по коду?

Каждая проблема оформляется в виде строки [FILE:LINE] ISSUE_TITLE с точным указанием строк и ссылкой на правила по настройке серверов или сессий.

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

SKILL.md · Apache-2.0
---
name: wish-ssh-code-review
description: Reviews Wish SSH server code for proper middleware, session handling, and security patterns. Use when reviewing SSH server code using charmbracelet/wish.
---

# Wish SSH Code Review

## Quick Reference

| Issue Type | Reference |
|------------|-----------|
| Server setup, middleware | [references/server.md](references/server.md) |
| Session handling, security | [references/sessions.md](references/sessions.md) |

## Review gates

Run these **in order** when producing a written review. Do not claim a defect in a later step until the **Pass when** for the current step is satisfied for the code under review.

1. **Locate Wish entry points** — **Pass when:** you have at least one repo path per server surface that calls `wish.NewServer`, `wish.WithMiddleware`, registers `bubbletea.Middleware`, or defines the top-level `ssh.Handler` chain (list the paths explicitly).
2. **Capture server-setup evidence** — **Pass when:** for each path from step 1, you have the actual `wish.WithHostKey*` / host-key configuration and the **full middleware list in source order** as written (not recalled from memory). If graceful shutdown exists, note the file(s) where `ListenAndServe` and `Shutdown` run.
3. **Capture session / TUI evidence** — **Pass when:** for each `teaHandler` (or equivalent), you have noted from source whether `s.Pty()` is checked before using window size, and whether per-session renderers (`bubbletea.MakeRenderer`) are used where Lipgloss styles apply.
4. **Write findings** — **Pass when:** each finding uses `[FILE:LINE] ISSUE_TITLE` (line range allowed where needed) and points to the relevant row in **Quick Reference** (or the matching section in `references/`).

## Review Checklist

Use alongside **Review gates**; for a written review, complete the gates first so each item below can be tied to cited source.

- [ ] Host keys are loaded from file or generated securely
- [ ] Middleware order is correct (logging first, auth early)
- [ ] Session context is used for per-connection state
- [ ] Graceful shutdown handles active sessions
- [ ] PTY requests are handled for terminal apps
- [ ] Connection limits prevent resource exhaustion
- [ ] Timeout middleware prevents hung connections
- [ ] BubbleTea middleware correctly configured

## Critical Patterns

### Server Setup

```go
// GOOD - complete server setup
s, err := wish.NewServer(
    wish.WithAddress(fmt.Sprintf("%s:%d", host, port)),
    wish.WithHostKeyPath(".ssh/id_ed25519"),
    wish.WithMiddleware(
        logging.Middleware(),       // first: log all connections
        activeterm.Middleware(),    // handle terminal sizing
        bubbletea.Middleware(teaHandler),
    ),
)
if err != nil {
    return fmt.Errorf("creating server: %w", err)
}
```

### Graceful Shutdown

```go
// BAD - abrupt shutdown
log.Fatal(s.ListenAndServe())

// GOOD - graceful shutdown
done := make(chan os.Signal, 1)
signal.Notify(done, os.Interrupt, syscall.SIGTERM)

go func() {
    if err := s.ListenAndServe(); err != nil && !errors.Is(err, ssh.ErrServerClosed) {
        log.Error("server error", "error", err)
    }
}()

<-done
ctx, cancel := context.WithTimeout(context.Background(), 30*time.Second)
defer cancel()
if err := s.Shutdown(ctx); err != nil {
    log.Error("shutdown error", "error", err)
}
```

### BubbleTea Handler

```go
func teaHandler(s ssh.Session) (tea.Model, []tea.ProgramOption) {
    pty, _, _ := s.Pty()

    model := NewModel(pty.Window.Width, pty.Window.Height)

    return model, []tea.ProgramOption{
        tea.WithAltScreen(),
        tea.WithMouseCellMotion(),
    }
}
```

## When to Load References

- Reviewing server initialization → server.md
- Reviewing authentication, session state → sessions.md

## Review Questions

1. Are host keys handled securely?
2. Is middleware order correct?
3. Is graceful shutdown implemented?
4. Are PTY window sizes passed to the TUI?
5. Are connection timeouts configured?

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

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

Все скиллы по теме «Код-ревью и рефакторинг» →
bubbletea GGPrompts Помогает проектировать консольные интерфейсы на Go с Bubbletea и Lipgloss. Помогает собирать панели и списки, отлаживать искажения разметки. CX Codex +1 512установок ssh Dicklesworthstone Помогает агенту подключаться к серверам по SSH, пробрасывать порты, синхронизировать файлы через rsync и управлять ключами. Пригодится при деплое и удалённой отладке. CX Codex +1 705установок ssh-configuration devops-skills Скилл ssh-configuration настраивает OpenSSH на клиенте и сервере, помогает выпускать ключи Ed25519, пробрасывать порты и поднимать бастион-хосты для безопасного удалённого доступа. CX Codex +1 527установок ssh-doctor steipete Скилл ssh-doctor диагностирует сбои SSH на macOS: обрывы до авторизации, зависшие сессии sshd и проблемы службы Remote Login. CX Codex +1 239установок ssh-remote oakoss Скилл ssh-remote помогает ассистенту настраивать SSH-подключения, генерировать ключи Ed25519, пробрасывать порты и безопасно передавать файлы. CX Codex +1 183установок ssh-penetration-testing zebbern Скилл ssh-penetration-testing для Claude Code помогает проверять SSH-сервисы: собирать сведения о конфигурации, тестировать учётные данные и настраивать туннели. Проводит аудит SSH в разрешённой среде. CX Codex +1 ★ 4 719звёзд репо

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

Весь набор →
reference-docs Скилл reference-docs помогает писать справочные страницы для API и функций: таблицы параметров, возвращаемые значения, ошибки, запускаемые примеры. CX Codex +1 121установок widgetkit-code-review Скилл widgetkit-code-review проверяет код виджетов на WidgetKit по чек-листу: таймлайн, вёрстка, настраиваемые интенты, память. Пригодится перед релизом виджета и после переезда на iOS 17. CX Codex +1 121установок pydantic-ai-model-integration Скилл pydantic-ai-model-integration помогает настроить провайдеров LLM, цепочки fallback, стриминг и лимиты токенов в библиотеке PydanticAI. CX Codex +1 120установок review-ai-writing Скилл review-ai-writing находит следы текстов нейросетей в документации, комментариях к коду, текстах коммитов и описаниях пулреквестов. Пригодится при проверке репозитория на канцелярский слог и роботизированные фразы. CX Codex +1 119установок urlsession-code-review Скилл urlsession-code-review разбирает сетевой код на URLSession в iOS и macOS: статус-коды, кэш, таймауты и фоновые сессии. Находки идут с привязкой file:line. CX Codex +1 116установок elixir-security-review Скилл elixir-security-review проверяет код на Elixir на уязвимости: инъекции кода, переполнение таблицы атомов и утечки секретов. CX Codex +1 110установок elixir-performance-review Скилл elixir-performance-review для Claude Code проверяет код на Elixir и ищет узкие места в GenServer, памяти, конкурентности и базе данных. Находит причины просадки сервиса под нагрузкой. CX Codex +1 107установок elixir-writing-docs Скилл elixir-writing-docs для Claude Code оформляет документацию Elixir в файлах .ex: аннотации ExDoc, doctests и метаданные. CX Codex +1 106установок

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

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