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

groove-admin-install — скилл для Claude Code: как установить

Скилл groove-admin-install разворачивает бэкенды Groove, сопутствующие скиллы и структуру хуков в репозитории. Нужен один раз при первичной инициализации рабочего пространства.

MIT 586 установок ★ 6 обновлён 2026-07-24

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

Что делает 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-code

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

~/.claude/skills/groove-admin-install/SKILL.md

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

По шагам, с командами для каждой платформы: Как установить скилл в 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

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

Все скиллы по теме «Настройка агента: память, контекст, субагенты» →
skill-install stellarlinkco Скилл skill-install для Claude Code автоматически скачивает скиллы из GitHub, проверяет код на уязвимости и устанавливает одобренные. CX Codex +1 226установок install-loop Cobus Greyling Скилл install-loop для Claude Code устанавливает Loop Engineering в проект через единую CLI-команду. Он выбирает шаблон цикла по проблеме и оставляет запуск в режиме отчётов на первую неделю. CX Codex +1 ★ 11 819звёзд репо codex-delegate amElnagdy Скилл codex-delegate для Claude Code передаёт задачу OpenAI Codex CLI в фоновую работу. Затем агент читает diff, повторно запускает проверки и сам применяет изменения. CX Codex +1 8 400установок gws-admin-reports официальный googleworkspace Скилл gws-admin-reports для Claude Code, Cursor и других IDE подключает Google Workspace Admin SDK, чтобы работать с логами аудита и отчётами об использовании — активностью в Admin консоли, Drive и другими метриками аккаунта. CX Codex +1 31 700установок gws-install jezweb Скилл gws-install ставит gws на второй компьютер по готовым OAuth-данным, чтобы не проходить настройку Google Cloud заново. CX Codex +1 1 100установок workflows-install zapier Скилл workflows-install готовит окружение для работы с Zapier Workflows Early Access. Ставит Zapier SDK CLI и шесть вспомогательных скиллов. CX Codex +1 475установок

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

Весь набор →
groove Скилл groove принимает запрос на обычном языке и направляет его к нужной команде рабочего процесса. Подходит для планирования, задач, памяти и администрирования. CX Codex +1 633установок groove-utilities-task-analyse Скилл groove-utilities-task-analyse собирает задачи из бэкенда проекта и раскладывает их по статусам, чтобы вечером было чем заполнить дневную память. CX Codex +1 590установок groove-utilities-memory-install Скилл groove-utilities-memory-install для Claude Code создаёт структуру памяти Groove в .groove/memory/ и показывает готовые пути. Инициализирует память проекта перед запуском других инструментов Groove. CX Codex +1 587установок groove-utilities-memory-log-daily Скилл groove-utilities-memory-log-daily записывает итог дня в .groove/memory/daily/YYYY-MM-DD.md: что сделано, какие были коммиты, что переносится на завтра. CX Codex +1 583установок groove-admin-config Скилл groove-admin-config для Claude Code интерактивно создаёт или обновляет .groove/index.md и задаёт правила Git перед установкой бэкендов. CX Codex +1 581установок groove-utilities-task-list Скилл groove-utilities-task-list для Claude Code и ещё пяти платформ показывает активные задачи из настроенного бэкенда, сгруппированные по статусу. Выводит задачи в работе, готовые к старту и заблокированные — с указанием, чего они ждут. CX Codex +1 579установок groove-admin-doctor Скилл groove-admin-doctor для Claude Code проверяет состояние Groove: репозиторий, версии, субскиллы, companions, symlinks и хуки. Помогает найти проблемы перед работой. CX Codex +1 573установок groove-daily-start Скилл groove-daily-start готовит рабочий день: просматривает прошлые дни, создаёт файл памяти на сегодня, собирает задачи и показывает повестку. CX Codex +1 573установок

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

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