worktrunk — скилл для Claude Code: работа с git worktree через wt
Скилл объясняет ИИ-агенту, как устроен CLI wt: какие worktree затрагивает команда, что лежит в конфигах и как писать хуки.
npx skills add max-sixty/worktrunk --skill worktrunk -a claude-codeЧто делает 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 ждёт подтверждения пользователя, так что на автоматический прогон в фоне не рассчитывайте.
Какие задачи решает
- понять, на какой worktree подействует команда
wt - написать хук на событие жизненного цикла worktree
- настроить генерацию сообщений коммитов через LLM
- развести пользовательский и проектный конфиги по правам
- собрать алиас или многошаговый pipeline из
wt-команд
Примеры запросов агенту
- Объясни, какой worktree выберет
wt switch beta, если я сейчас в другом worktree - Добавь в
.config/wt.tomlхукpre-start, который ставит зависимости черезnpm install - Настрой генерацию сообщений коммитов в пользовательском конфиге worktrunk
Как установить worktrunk
1Через Skills CLI (Vercel)
npx skills add max-sixty/worktrunk --skill worktrunk -a claude-code2Вручную: положить файлы
~/.claude/skills/worktrunk/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/worktrunk/
1Через Skills CLI (Vercel)
npx skills add max-sixty/worktrunk --skill worktrunk -a codex2Вручную: положить файлы
.agents/skills/worktrunk/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add max-sixty/worktrunk --skill worktrunk -a cursor2Вручную: положить файлы
.cursor/skills/worktrunk/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install max-sixty/worktrunk worktrunk2Вручную: положить файлы
.github/skills/worktrunk/SKILL.md1Через Skills CLI (Vercel)
npx skills add max-sixty/worktrunk --skill worktrunk -a gemini-cli2Командой платформы
gemini skills install https://github.com/max-sixty/worktrunk --path skills/worktrunkВручную: положить файлы
.devin/skills/worktrunk/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add max-sixty/worktrunk --skill worktrunk -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о worktrunk
Как установить worktrunk в Claude Code?
Выполните npx skills add max-sixty/worktrunk --skill worktrunk -a claude-code. Скилл окажется в ~/.claude/skills/worktrunk/SKILL.md.
Что делает скилл worktrunk?
Даёт агенту справочник по CLI wt: разбор конфигов, типы хуков, команды и рецепты алиасов. Агент обращается к нему при правке конфигурации worktrunk или отладке поведения wt.
Что нужно для работы скилла?
Установленный CLI wt — на нём держатся все примеры и команды. Хуки проекта в неинтерактивных сессиях требуют подтверждения пользователя.
