Agent Skill Manager

A CLI tool for managing Agent Skills.

Supported Coding Agents: Claude Code, OpenCode, Codex, Gemini CLI (+ custom integrations)

Current Limitations:

• Windows is not supported (uses Unix symlinks)

How it works

The tool clones repositories containing skills to a local cache directory. When you enable a skill, it creates symlinks in all your registered coding agents' skill directories. Disabling a skill removes the symlinks while keeping the repository cached for fast re-enabling.

Local repositories (/path/to/dir, ~/dir, ./dir) skip cloning entirely — symlinks point directly to the source directory. Changes you make to local skill files are reflected immediately without needing sm upgrade.

Installation

Installer Script (macOS and Linux)

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/jroslaniec/agent-skill-manager/releases/latest/download/agent-skill-manager-installer.sh | sh

From Source

cargo install --path .

Quick Start

After installation, configure which coding agents you use:

# Interactive setup - select your coding agents
sm configure

# Or add individually
sm integrations add claude-code
sm integrations add opencode

Then add skills:

sm add github.com/anthropics/skills/skills/pdf

Usage

Interactive Mode

The easiest way to manage skills is through the interactive UI:

# Manage all skills from all repositories
sm

# Add repository and interactively select skills
sm add -i github.com/anthropics/skills/skills

Add Skills

Add skills to your global Claude Code configuration:

# Add a skill
sm add github.com/anthropics/skills/skills/pdf

# Add multiple skills
sm add \
  github.com/anthropics/skills/skills/pdf \
  github.com/anthropics/skills/skills/docx

# Add a local skill directly (auto-registers parent as local repo)
sm add /path/to/my-skill
sm add /path/to/my-skill/SKILL.md

# Interactive mode - select skills from a repository
sm add -i github.com/anthropics/skills/skills

Add a Repository

If you want to add a repository without enabling skills, use:

# HTTPS (any host)
sm repo add github.com/anthropics/skills/skills
sm repo add gitlab.com/owner/repo

# SSH
sm repo add git@github.com:owner/repo.git
sm repo add git@gitlab.com:owner/repo.git

# Local paths
sm repo add /path/to/local/repo
sm repo add ~/projects/my-skills
sm repo add ./relative/path

# File URLs
sm repo add file:///path/to/repo

Repositories should contain skill and/or agent directories:

• Each skill directory needs a SKILL.md file
• Each agent directory needs an AGENT.md file

repo-root/
├── skill-name-1/
│   └── SKILL.md
├── skill-name-2/
│   └── SKILL.md
├── agent-name-1/
│   └── AGENT.md

You can also add a repository from a nested path:

sm repo add github.com/owner/repo/path/to/skills
sm repo add /path/to/local/repo/skills

Example with nested structure:

repo-root/
├── tools/
│   └── agent-skills/
│       ├── skill-a/
│       │   └── SKILL.md
│       └── agent-b/
│           └── AGENT.md

For this structure, use: sm repo add github.com/owner/repo/tools/agent-skills

Repository Version Management

Pin repositories to specific commits to prevent accidental updates:

# Add repository pinned to specific commit
sm repo add github.com/owner/repo@abc12345

# Pin existing repository to current commit
sm repo pin github.com/owner/repo

# Unpin to allow upgrades
sm repo unpin github.com/owner/repo

# Upgrade to latest commit
sm repo upgrade github.com/owner/repo

# Upgrade to specific commit (auto-pins)
sm repo upgrade github.com/owner/repo@abc12345

# Upgrade all unpinned repositories
sm upgrade
sm upgrade --force  # Skip confirmation

Note: Local repositories cannot be pinned or unpinned (no SHA tracking). Running sm upgrade on local repos re-scans the directory for new or removed skills and agents without performing any git operations. Deleting a local repo (sm repo delete) removes symlinks and config but does not delete the source directory.

Enable/Disable Skills

# Interactive mode (easiest)
sm

# Enable using full reference
sm skill enable github.com/anthropics/skills/skills/pdf
sm enable github.com/anthropics/skills/skills/pdf

# Or just the skill name if already registered
sm skill enable pdf
sm enable pdf

# Disable (works with both name and full reference)
sm skill disable pdf
sm disable pdf

Enable/Disable Subagents

Subagents are similar to skills but integrated into specific coding agents (Claude Code, OpenCode, etc.):

# List all subagents
sm subagents list
sm subagents list --all

# Enable subagents
sm subagents enable my-agent
sm subagent enable owner/repo/my-agent

# Disable subagents
sm subagents disable my-agent
sm subagent disable owner/repo/my-agent

# Interactive management
sm  # Bare command shows both skills and agents

Subagents are discovered automatically from AGENT.md files in repositories, just like skills are discovered from SKILL.md files.

Auxiliary Commands

# List skills
sm list
sm list --all

# List repositories
sm repo list

# Remove a repository and all its skills
sm repo delete github.com/anthropics/skills/skills

# Show cache directory location
sm cache dir

# Purge everything (remove all repositories, skills, and cache)
sm purge

Manage Integrations

Configure which coding agents receive your skills:

# Interactive setup
sm configure

# Add built-in integrations
sm integrations add claude-code    # ~/.claude/skills/
sm integrations add opencode       # ~/.config/opencode/skill/
sm integrations add codex          # ~/.codex/skills/
sm integrations add gemini-cli     # ~/.gemini/skills/

# Add custom integration
sm integrations add cursor --path ~/.cursor/skills

# List integrations (shows all presets + custom)
sm integrations list

# Remove an integration
sm integrations remove cursor

Aliases are supported: claude → claude-code, gemini → gemini-cli

Command Aliases

The tool supports multiple aliases for convenience:

• repositories, repository, repos, repo - Repository commands
• skills, skill, sk - Skill commands
• subagents, subagent - Subagent commands
• integrations, integration, int - Integration commands
• list, ls - Shortcut for skills list
• enable - Shortcut for skills enable
• disable - Shortcut for skills disable
• configure, config - Configure integrations