# worktrunk

Скилл объясняет ИИ-агенту, как устроен CLI wt: какие worktree затрагивает команда, что лежит в конфигах и как писать хуки.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 5300 установок · ★ 9480
- Автор: max-sixty
- Лицензия: не указана · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/max-sixty/worktrunk/tree/HEAD/skills/worktrunk/SKILL.md
- Обновлён: 2026-10-23
- HTML: https://affpapa.org/nevibecode/skills/worktrunk

## Что делает

Worktrunk — консольная утилита для git worktree, а этот скилл даёт агенту справочник по ней. Внутри — файлы `reference/` по конфигурации, хукам, командам `switch`, `merge`, `list`, генерации сообщений коммитов, алиасам и отладке. Агент подгружает их, когда надо понять, на какой worktree подействует `wt`-команда, или когда правит `.config/wt.toml` и `~/.config/worktrunk/config.toml`.

Главное правило, которое скилл разбирает: ветка в аргументе уже задаёт worktree, а глобальный `-C <path>` меняет рабочий каталог, а не выбор worktree. Сложить одно с другим — значит назвать один и тот же worktree дважды. Конфиги делятся по правам: пользовательский `~/.config/worktrunk/config.toml` не попадает в git, поэтому скилл советует сначала предложить правку и получить согласие; проектный `<repo>/.config/wt.toml` версионируется, его можно менять смелее.

Скиллу нужен установленный CLI `wt` — без него команды из примеров просто не выполнятся. Хуки проект запускает не сразу: в неинтерактивных сессиях Worktrunk ждёт подтверждения пользователя, так что на автоматический прогон в фоне не рассчитывайте.

## Установка

### Claude Code (родная платформа)

1. **Через Skills CLI (Vercel)**
```bash
npx skills add max-sixty/worktrunk --skill worktrunk -a claude-code
```

2. **Вручную: положить файлы**
- Файл: `~/.claude/skills/worktrunk/SKILL.md` — Папка скилла целиком; для одного проекта — .claude/skills/worktrunk/

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add max-sixty/worktrunk --skill worktrunk -a codex
```

2. **Вручную: положить файлы**
- Файл: `.agents/skills/worktrunk/SKILL.md` — Для всех проектов — ~/.agents/skills/

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add max-sixty/worktrunk --skill worktrunk -a cursor
```

2. **Вручную: положить файлы**
- Файл: `.cursor/skills/worktrunk/SKILL.md` — Cursor читает и .agents/skills/, и .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install max-sixty/worktrunk worktrunk
```

2. **Вручную: положить файлы**
- Файл: `.github/skills/worktrunk/SKILL.md`

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add max-sixty/worktrunk --skill worktrunk -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/max-sixty/worktrunk --path skills/worktrunk
```

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/skills/worktrunk/SKILL.md` — Старый путь .windsurf/skills/ тоже читается

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add max-sixty/worktrunk --skill worktrunk -a opencode
```

### Claude.ai

**Claude.ai**
- Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/max-sixty/worktrunk/tree/HEAD/skills/worktrunk/SKILL.md

## Когда брать
- понять, на какой worktree подействует команда `wt`
- написать хук на событие жизненного цикла worktree
- настроить генерацию сообщений коммитов через LLM
- развести пользовательский и проектный конфиги по правам
- собрать алиас или многошаговый pipeline из `wt`-команд

## Примеры запросов агенту
- Объясни, какой worktree выберет `wt switch beta`, если я сейчас в другом worktree
- Добавь в `.config/wt.toml` хук `pre-start`, который ставит зависимости через `npm install`
- Настрой генерацию сообщений коммитов в пользовательском конфиге worktrunk

## Похожие
- [triage](https://affpapa.org/nevibecode/skills/triage.md) — скилл · 990453 установки
- [code-review](https://affpapa.org/nevibecode/skills/code-review.md) — скилл · 789521 установка
- [implement](https://affpapa.org/nevibecode/skills/implement.md) — скилл · 774700 установок
- [git-guardrails-claude-code](https://affpapa.org/nevibecode/skills/git-guardrails-claude-code.md) — скилл · 499069 установок
- [setup-pre-commit](https://affpapa.org/nevibecode/skills/setup-pre-commit.md) — скилл · 489289 установок
- [scaffold-exercises](https://affpapa.org/nevibecode/skills/scaffold-exercises.md) — скилл · 480196 установок

Из того же набора: [max-sixty/worktrunk](https://affpapa.org/nevibecode/by/max-sixty/worktrunk.md) — 2 карточки

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md