skill-cli

skill-cli is a command-line tool for managing shared skill repositories and syncing them into target directories with symlinks.

Features

• Add a skill repository once and reuse it across multiple targets
• Clone repositories locally on first add
• Sync all discovered skills into target directories with symlinks
• Update all configured repositories with one command
• Update a single repository with --repo
• Remove repositories and targets cleanly

Requirements

• Go 1.22 or later
• curl
• tar

Installation

Install with curl | bash:

curl -fsSL https://raw.githubusercontent.com/CuberL/skill-cli/main/install.sh | bash

Install to a custom directory:

curl -fsSL https://raw.githubusercontent.com/CuberL/skill-cli/main/install.sh | INSTALL_DIR="$HOME/.local/bin" bash

Install a specific tag:

curl -fsSL https://raw.githubusercontent.com/CuberL/skill-cli/main/install.sh | SKILL_CLI_VERSION="v0.1.0" bash

By default, the installer uses /usr/local/bin when writable, otherwise it falls back to ~/.local/bin.

Usage

Add a repository:

skill-cli add https://github.com/example/skills.git

Add a local directory without copying it into ~/.skill-cli/repos:

skill-cli add ~/Documents/my-skills

Remove a repository:

skill-cli remove my-skills
skill-cli remove https://github.com/example/skills.git

Add targets:

skill-cli target add ~/.codex/skills
skill-cli target add ~/.cursor/skills
skill-cli target add ~/.claude/skills/

Remove a target:

skill-cli target remove ~/.codex/skills

List current configuration:

skill-cli list
skill-cli list --all
skill-cli target list

Sync all configured repositories to all targets:

skill-cli sync

Update all repositories:

skill-cli update

Update a single repository:

skill-cli update --repo my-skills
skill-cli update --repo https://github.com/example/skills.git

Typical Workflow

skill-cli add https://github.com/example/team-skills.git
skill-cli target add ~/.codex/skills
skill-cli target add ~/.cursor/skills
skill-cli target add ~/.claude/skills/
skill-cli update

Notes

• skill-cli add automatically syncs the new repository to all existing targets.
• skill-cli target add automatically syncs all configured repositories to the new target.
• skill-cli remove removes the configured repository, deletes its local clone, and cleans up matching symlinks from all targets.
• skill-cli target remove removes the target from configuration and cleans up matching symlinks in that target.
• If a target already contains a non-symlink path with the same skill name, skill-cli will report a conflict instead of overwriting it.