caddie

Skill Profile Manager for Claude Code & other coding agents

caddie manages skills from registered git repos and creates project-specific skill profiles for Claude Code and other agents. It maintains a canonical skill store and configures agent-specific skill directories via symlinks.

Quick Install

Requires Go 1.22+ (`brew install go`).

./scripts/build.sh
cp dist/caddie /usr/local/bin/caddie

# Initialize (creates config directories, skill store, ~/.claude/skills symlink)
caddie init

The repo also keeps `ai-env-frozen` — the original bash implementation, retained as the parity oracle for the contract test suite. It is not installed by default.

First-time Setup

`caddie init` does the heavy lifting:

1. Creates ~/.config/caddie/ with default configuration
2. Creates ~/.config/caddie/environments/ for your project profiles
3. Creates an empty ~/.config/caddie/sources.yaml repo registry
4. Backs up your existing ~/.claude/skills/ to ~/.claude/skills.bak.YYYY-MM-DD
5. Migrates any hand-written skills to ~/.agents/skills/ (canonical store)
6. Replaces ~/.claude/skills/ with symlinks managed by caddie

After init, register git repos with `caddie repo add ` and run `caddie scan`.

Usage Flow

1. Register & update skill repos

caddie repo add lenny https://github.com/RefoundAI/lenny-skills    # register + clone
caddie repo add my-team git@host:org/skills.git skills             # custom skills_path
caddie repo list                                                   # show registered repos + status
caddie repo update                                                 # git pull every repo
caddie repo update lenny                                           # pull a specific one
caddie repo remove lenny