SkillKeeper

SkillKeeper installs and manages skills and hooks for AI coding agents (Claude, Codex, Copilot, Cursor, OpenCode).

Overview

SkillKeeper comes in two forms over one shared Rust core:

• A desktop app for browsing and installing Git repositories of skills, their hooks, and sets of MCP server presets - for AI coding agents, either per-project or globally.
• A command-line tool (skillkeeper) that does the same from your shell and in scripts.

Skills are distributed as Git repositories; a repository can also ship MCP server presets. SkillKeeper clones a repository, resolves what it provides, installs the parts you choose into the agents you target, and tracks everything for updates. Supported agents: Claude, Codex, Copilot, Cursor, and OpenCode.

Install

Desktop app -- download the bundle for your platform from the latest release.

CLI (skillkeeper) -- one line, using only tools already on your system. The script detects your platform, downloads the matching CLI archive from the latest release, and adds the binary to your PATH.

macOS / Linux:

curl -fsSL https://raw.githubusercontent.com/lorem-dev/skillkeeper/main/scripts/install.sh | sh

Windows (PowerShell):

irm https://raw.githubusercontent.com/lorem-dev/skillkeeper/main/scripts/install.ps1 | iex

See Getting Started for other options.

Hitting an install problem (for example macOS reporting the app as "damaged")? See Troubleshooting.

CLI quick start

The CLI binary is skillkeeper. Every command exits non-zero on failure.

Add a repository of skills, then see what it provides:

skillkeeper repo add git@github.com:example/skills.git
skillkeeper skill list

Install a skill for an agent (per-project by default; add --global for machine-wide). Hooks are privileged and only installed with --allow-hooks:

skillkeeper skill install <skill-id> --agent claude
skillkeeper skill install <skill-id> --agent codex --global --allow-hooks

Track a project, then check for available updates across its repositories and installed skills:

skillkeeper project add .
skillkeeper check

Inspect, verify against the manifest, and repair an installation:

skillkeeper skill info <skill-id>
skillkeeper skill verify <skill-id>
skillkeeper skill repair <skill-id>

Supported agents are claude, codex, copilot, cursor, and opencode. Run skillkeeper --help (or <command> --help) for the full command set, also documented in the CLI Reference.

Repositories

A repository is any Git remote (SSH or HTTPS, public or private) that contains one or more skills, and optionally MCP server presets. A skill is a directory with a manifest plus the files it installs; hooks are opt-in edits a skill can make to an agent's configuration. To publish your own skills, create a Git repository with that layout and point SkillKeeper at it with repo add.

See Repositories and Skills and Hooks for the repository format and authoring guide.

Example repository

skillkeeper-test-repo is a fixture repository that exercises every documented resolution path: flat and grouped skills, both hook layouts, guidance-file precedence, MCP presets at the repository root and inside a group, and a deliberately unresolvable skill. It is wired into this repository as a Git submodule at examples/test-repo. Fetch it with git submodule update --init (the submodule uses an SSH remote, so this needs a GitHub SSH key; the fixture is not required by any build or test).

Entry points -- the links go to GitHub, the paths are where the files land once the submodule is checked out:

• minimal-skill/SKILL.md -- the smallest valid skill manifest.
• json-hooks-skill/hooks/pre-tool-use/HOOK.md -- a hook that merges into an agent's JSON config.
• mcp.yml and tooling/mcp.yml -- root and group-scoped MCP presets.

Links into a submodule cannot be relative: this repository's tree stores examples/test-repo as a commit pointer, not as files, so a relative path would 404 on GitHub.

Development

SkillKeeper is a Rust + pnpm monorepo: a Cargo workspace of domain crates (skillkeeper-core, skillkeeper-config, skillkeeper-agents, skillkeeper-cli) with a Tauri v2 + React desktop app, all over one shared Rust core.

See the Development guide for setup, commands, and conventions.

License

Apache-2.0. See LICENSE.