skills

Manages agent skill extensions — discovery, installation, and lock file maintenance. Everything is a skill: workflow skills (like groove itself), integration skills, and capability skills are all managed the same way.

Git Root Detection

Before running any command, detect the git root:

git rev-parse --show-toplevel

skills-lock.json is at git root.

Commands

Command	Description
find	Search for skills by keyword or category
add <owner/repo>	Install a skill via npx skills add
remove <name>	Remove a skill and update lock file
install	Install configured finder backend + run all skill installs in order
check	Check for updates to all installed skills

$ARGUMENTS Routing

$ARGUMENTS	Action
find	→ commands/find.md
add <owner/repo>	→ commands/add.md
remove <name>	→ commands/remove.md
install	→ commands/install.md
check	→ commands/check.md
(empty)	Show this help and available commands

Backend Pattern

Each groove skill that wraps an external backend owns its own config key and install command:

Skill	Config key	Default backend
task	tasks	beans
memory	sessions	bonfire
skills	finder	find-skills

skills install coordinates all installs in dependency order: task → memory → skills/finder.

Design Note

skills-lock.json is auto-generated output — a record of installed skills. It is not the install source of truth (that lives in .groove/index.md config keys). Think of it like package-lock.json vs package.json.