agent-skills-installer

A CLI tool to copy Agent Skills from git repos into local directories for coding agents.

Install

uv tool install agent-skills-installer

Or run directly without installing:

uvx agent-skills-installer

Note: uv must be installed. See https://docs.astral.sh/uv/getting-started/installation/ for installation instructions.

Usage

Install skills (default command)

# Interactive — prompts for destination, repo, and skill selection
agent-skills-installer

# Fully non-interactive
agent-skills-installer install \
  --destination ~/.claude/skills/ \
  --source https://github.com/anthropics/skills \
  --skill skill-creator

Options:

Update skills

# Interactive — prompts for destination, confirms before updating
agent-skills-installer update

# Non-interactive
agent-skills-installer update -d ~/.claude/skills/ -k skill-creator

Options:

How it works

1. Skills are discovered in the source repo, trying these layouts in order and using the first that matches:
   • skills/ or .claude/skills/ (searched recursively, so skills/<category>/<name>/ works)
   • a SKILL.md at the repo root — the repo is itself a single skill
   • a repo-wide search, covering root-level collections (<name>/SKILL.md) and plugin layouts (<plugin>/skills/<name>/SKILL.md)
2. Each skill directory (containing a SKILL.md with a name in its frontmatter) is copied to the destination, named after that name
   • Any other skill from the same repo whose name appears in a selected skill's compatibility frontmatter is treated as a dependency and installed too (transitively). The confirmation summary lists these and which skill required each one.
3. metadata.git-repo and metadata.git-sha entries are added to the SKILL.md frontmatter to track the source repo and the commit the skill was copied at
4. The update command uses that metadata to refresh skills from their original repos

Configuration (last destination, recent repos) is saved to ~/.agent-skills-installer/config.toml.

License

MIT