SkillsAdd

andreadellacorte/groove

groove-admin-config

Create or update .groove/index.md config interactively. Run before groove install.

First seen Mar 4, 2026

Installation

$ npx skills add andreadellacorte/groove --skill groove-admin-config
View on skills.sh ↗ GitHub repository ↗

Also in this package

Other skills from andreadellacorte/groove · top by installs.

npx skills add andreadellacorte/groove
groove 625 groove-utilities-task-analyse 582 groove-admin-install 579 groove-utilities-memory-install 578 groove-utilities-task-install 575 groove-utilities-memory-log-daily 573 groove-utilities-task-list 571 groove-admin-doctor 565 groove-daily-start 565 groove-daily-end 551

Browse all from andreadellacorte/groove

More details

Agent compatibility

Declared targets from SKILL.md / docs. Unmarked agents are not listed — the skill may still install via the CLI.

Claude Code Not declared
Cursor Not declared
Codex Not declared
GitHub Copilot Not declared
Windsurf Not declared
Gemini CLI Not declared
Cline Not declared
OpenCode Not declared

Repository health

Stars 5
License LICENSE
Default branch main
Open issues 0
Status Active

Skill metadata

Parsed from SKILL.md frontmatter.

LicenseMIT
Allowed toolsRead Write Edit Glob Grep Bash(git:*) Bash(beans:*) Bash(gh:*) Bash(linear:*) Bash(npx:*) Bash(mkdir:*) AskUserQuestion
More metadata
author
andreadellacorte

Package contents

Files included with this skill beyond the listing page.

  • skill md SKILL.md 4,666 B
  • docs SUMMARY.md 106 B

History

  1. First seen on skills.sh
  2. First recorded snapshot · 574 installs

SKILL.md

<!-- groove:managed — do not edit; changes will be overwritten by groove update -->

groove-admin-config

Outcome

.groove/index.md is created or updated with values confirmed by the user. The git strategy is applied immediately. User is ready to run /groove-admin-install.

Acceptance Criteria

  • .groove/index.md exists with all config keys populated
  • Each key was either confirmed by the user or accepted as default
  • Git strategy is applied (.groove/.gitignore written) before exiting
  • User is shown a summary of the final config and told to run /groove-admin-install

Steps

If --defaults is passed: skip all prompts, apply all defaults, and proceed directly to writing the config (step 1 of "After all keys are confirmed"). Report the defaults being applied.

Otherwise, walk the user through each config key in order. For each key: show the current value (or default if new), explain what it does, and ask to confirm or change.

Keys and defaults

Key Default Options Question to ask
tasks.storage beans `beans \ linear \ github \ none` "Which task backend? beans tracks tasks as markdown files in your repo."
tasks.list_limit 15 positive integer "Max tasks shown by task-list? (default: 15)"
tasks.analyse_limit 30 positive integer "Max tasks shown by task-analyse? (default: 30)"
memory.review_days 5 positive integer "How many recent business days to review at daily start? (default: 5)"
git.memory ignore-all `ignore-all \ hybrid \ commit-all` "Git strategy for memory logs? ignore-all keeps them local, hybrid commits logs but ignores sessions, commit-all commits everything."
git.tasks ignore-all `ignore-all \ commit-all` "Git strategy for task files (.groove/tasks/)? ignore-all keeps them local, commit-all tracks them in git."
git.hooks commit-all `ignore-all \ commit-all` "Git strategy for hooks (.groove/hooks/)? commit-all shares hooks with the team, ignore-all keeps them local."
groovebook andreadellacorte/groovebook <owner>/<repo> or blank "Groovebook repo for sharing learnings? Default: andreadellacorte/groovebook. Leave blank to disable."

After all keys are confirmed:

  1. Write .groove/index.md with confirmed values and groove-version: <installed version>
  2. Apply git strategy — write .groove/.gitignore (see constraints)
  3. Show summary of written config
  4. Tell user: "Run /groove-admin-install to install backends."

Constraints

  • If .groove/index.md already exists, pre-fill each question with the current value
  • Always write groovebook: (default andreadellacorte/groovebook; blank = disabled). Memory path (.groove/memory/) and specs path (.groove/memory/specs/) are hardcoded — do not prompt for them.
  • If --defaults is passed, apply all defaults without any prompting — used by groove-admin-install for zero-friction first-time setup
  • If other arguments are provided (e.g. tasks=linear git.memory=hybrid), apply them without prompting and use defaults for any unspecified keys
  • Always write groove-version: matching the installed version from skills/groove/SKILL.md

Git strategy → .groove/.gitignore

After writing .groove/index.md, generate .groove/.gitignore from the git.* sub-keys:

Component Strategy Entry added to .groove/.gitignore
git.memory ignore-all memory/
git.memory hybrid memory/sessions/
git.memory commit-all (none)
git.tasks ignore-all tasks/
git.tasks commit-all (none)
git.hooks ignore-all hooks/
git.hooks commit-all (none)

Write the generated entries to .groove/.gitignore, replacing the file entirely. If no entries are generated (all commit-all), write an empty file with a comment: # groove git strategy: commit-all.

Always append these lines at the end of .groove/.gitignore, regardless of strategy:

# cache — always local
.cache/*
!.cache/.gitkeep
  • If .groove/ is listed in the root .gitignore, warn the user: "Note: .groove/ is in your root .gitignore — any commit-all strategies require removing it."
  • Do not modify the root .gitignore automatically — flag it for the user to resolve