groove-admin-install — скилл для Claude Code: как установить
Скилл groove-admin-install разворачивает бэкенды Groove, сопутствующие скиллы и структуру хуков в репозитории. Нужен один раз при первичной инициализации рабочего пространства.
MIT 586 установок ★ 6 обновлён 2026-07-24
npx skills add andreadellacorte/groove --skill groove-admin-install -a claude-codeЧто делает groove-admin-install
Скилл отвечает за однократную первичную подготовку репозитория к работе под управлением Groove. Он последовательно настраивает бэкенды задач и памяти, генерирует конфигурацию .groove/index.md с параметрами по умолчанию, готовит каталоги хуков и заполняет файл AGENTS.md.
При выполнении скрипт строго соблюдает порядок зависимостей. После развёртывания бэкендов задач через /groove-utilities-task-install и памяти через /groove-utilities-memory-install процесс загружает три обязательных скилла: find-skills, agent-browser и pdf-to-markdown. Затем он создаёт относительные симлинки из папки .agents/skills/ в каталоги .claude/skills/ и .cursor/skills/ через команду ln -sfn, чтобы редакторы сразу распознавали команды.
Без доступного npx процесс завершится сбоем. Инсталляция считается успешной только при наличии всех трёх дополнительных скиллов и корректных симлинков на диске.
Какие задачи решает
- развернуть инфраструктуру Groove в чистом репозитории
- настроить симлинки скиллов для Claude Code и Cursor
- загрузить обязательные скиллы find-skills, agent-browser и pdf-to-markdown
- подготовить базовые хуки сессий в папке .groove/hooks
Примеры запросов агенту
- Инициализируй Groove в этом репозитории через /groove-admin-install
- Запусти /groove-admin-install для настройки бэкендов и привязки скиллов к редакторам
Как установить groove-admin-install
1Через Skills CLI (Vercel)
npx skills add andreadellacorte/groove --skill groove-admin-install -a claude-code2Вручную: положить файлы
~/.claude/skills/groove-admin-install/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/groove-admin-install/
1Через Skills CLI (Vercel)
npx skills add andreadellacorte/groove --skill groove-admin-install -a codex2Вручную: положить файлы
.agents/skills/groove-admin-install/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add andreadellacorte/groove --skill groove-admin-install -a cursor2Вручную: положить файлы
.cursor/skills/groove-admin-install/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install andreadellacorte/groove skills/groove-admin-install2Вручную: положить файлы
.github/skills/groove-admin-install/SKILL.md1Через Skills CLI (Vercel)
npx skills add andreadellacorte/groove --skill groove-admin-install -a gemini-cli2Командой платформы
gemini skills install https://github.com/andreadellacorte/groove --path skills/groove-admin-installВручную: положить файлы
.devin/skills/groove-admin-install/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add andreadellacorte/groove --skill groove-admin-install -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о groove-admin-install
Как установить groove-admin-install в Claude Code?
Выполните команду npx skills add andreadellacorte/groove --skill groove-admin-install -a claude-code в терминале.
Что делает groove-admin-install?
Скилл настраивает бэкенды задач и памяти, скачивает обязательные сопутствующие инструменты, настраивает симлинки для редакторов и создаёт шаблоны хуков старта и завершения сессий.
Какие сопутствующие скиллы загружаются во время установки?
Процесс обязательно устанавливает три инструмента в .agents/skills/: find-skills, agent-browser и pdf-to-markdown. Без их наличия статус готовности не подтверждается.
Исходный текст
SKILL.md · MIT
---
name: groove-admin-install
description: "Install groove backends, companions, and AGENTS.md bootstrap. Run once per repo."
license: MIT
allowed-tools: Read Write Edit Glob Grep Bash(git:*) Bash(beans:*) Bash(gh:*) Bash(linear:*) Bash(npx:*) Bash(mkdir:*) AskUserQuestion
metadata:
author: andreadellacorte
---
<!-- groove:managed — do not edit; changes will be overwritten by groove update -->
# groove-admin-install
## Outcome
All groove backends are installed in dependency order, **companion skills and groove skill symlinks are present** (first install is not complete without them), AGENTS.md contains the session bootstrap, and the repo is ready for use.
## Acceptance Criteria
- Task and memory backends installed (or clearly reported if a step failed)
- **Companion skills installed** (find-skills, agent-browser, pdf-to-markdown) — required; verify each `SKILL.md` exists after step 4
- **Platform symlinks** — `.claude/skills/groove*` and `.cursor/skills/groove*` point at `.agents/skills/groove*` — required on every install run
- User sees a summary of what was installed, including ✓/✗ for companions and symlinks
## Steps
Run in order:
1. If `.groove/index.md` does not exist, run `/groove-admin-config --defaults` to create it with all defaults (no prompts)
2. Run `/groove-utilities-task-install` — installs the configured task backend (e.g. beans)
3. Run `/groove-utilities-memory-install` — creates memory directories
4. **Install companion skills (mandatory — do not skip):** On first install and every later run, ensure these exist under `.agents/skills/`. If `SKILL.md` is missing, run the matching `npx skills add` command; on transient failure, retry once, then report failure (install is **not** complete until all three succeed).
- **find-skills** (downloaded): `test -f .agents/skills/find-skills/SKILL.md` or `npx skills add https://github.com/vercel-labs/skills --skill find-skills`
- **agent-browser** (downloaded): `test -f .agents/skills/agent-browser/SKILL.md` or `npx skills add https://github.com/vercel-labs/agent-browser --skill agent-browser`
- **pdf-to-markdown** (embedded): `test -f .agents/skills/pdf-to-markdown/SKILL.md` or `npx skills add andreadellacorte/groove --skill pdf-to-markdown`
- Afterward, verify: `test -f` each of the three `SKILL.md` paths — if any missing, stop and report install incomplete (do not claim success).
- Report each as installed / already-present / failed
5. **Sync platform skill directories via symlinks (mandatory — do not skip):** Groove skills must be linked into each editor’s skills tree so `groove-*` commands resolve.
- Create parent dirs if missing: `mkdir -p .claude/skills .cursor/skills` (Claude Code expects `.claude/skills/`; Cursor expects `.cursor/skills/`)
- For each directory in `.agents/skills/` that starts with `groove`:
- Create `.claude/skills/<name>` as a symlink → `../../.agents/skills/<name>`
- Create `.cursor/skills/<name>` as a symlink → `../../.agents/skills/<name>`
- Run: `mkdir -p .claude/skills .cursor/skills && for skill in .agents/skills/groove*; do name=$(basename "$skill"); ln -sfn "../../.agents/skills/$name" ".claude/skills/$name"; ln -sfn "../../.agents/skills/$name" ".cursor/skills/$name"; done`
- Note: use `ln -sfn` (no-dereference) — `ln -sf` on an existing directory symlink follows the symlink and creates a nested symlink inside the target directory
- Verify: at least one `groove-*` name exists under `.agents/skills/` and matching symlinks exist under `.claude/skills/` and `.cursor/skills/`
- Report: "✓ platform symlinks updated (.claude/skills/, .cursor/skills/)" or report failure
6. Scaffold hooks and cache directories:
- Create `.groove/hooks/` if it does not exist
- Create `.groove/.cache/` if it does not exist (with a `.gitkeep`)
- If `.groove/hooks/start.md` does not exist, create it with:
```markdown
# Hook: Session Start
Runs automatically at the end of `/groove-daily-start`.
Add items to `## Actions` to automate session-start tasks.
## Actions
<!-- Add actions here, one per line. Examples:
- Run `git fetch --all` to refresh remote refs
- Print "Good morning — groove is ready"
-->
```
- If `.groove/hooks/end.md` does not exist, create it with:
```markdown
# Hook: Session End
Runs automatically at the end of `/groove-daily-end`.
Add items to `## Actions` to automate session-end tasks.
## Actions
<!-- Add actions here, one per line. Examples:
- Run `git push` to push today's commits
- Print "Session closed — see you tomorrow"
-->
```
- Report hooks: created / already-present
7. Apply git strategy — write `.groove/.gitignore` from `git.*` sub-keys in `.groove/index.md` (see `/groove-admin-config` for rules)
## Constraints
- Read `.groove/index.md` for `tasks.backend` and `git.*` config before running
- If `.groove/index.md` does not exist, `/groove-admin-config` is run first (step 1) to create it
- Dependency order for backends must be respected: task → memory → companions
- Each step reports installed / already-present / failed
- `AGENTS.md` update is additive per section — preserve all other content
- If task or memory install fails, report it clearly and continue — user may still need companions + symlinks
- **Steps 4–5 (companion skills + symlinks) are required for a successful install:** do not report "install complete" until both steps succeeded. This is intentional: first-time bootstrap must leave skills discoverable in Cursor and Claude Code.
- Companion skills (find-skills, agent-browser, pdf-to-markdown) are hardcoded here, not read from any config file
- Report a final summary (include platform symlinks line):
```
✓ task backend (beans)
✓ memory backend — memory dirs ready
✓ companion: find-skills
✓ companion: agent-browser
✓ companion: pdf-to-markdown
✓ platform symlinks (.claude/skills/, .cursor/skills/)
✓ hooks: .groove/hooks/ ready
```
© andreadellacorte · MIT · andreadellacorte/groove