skill-manager

Manage your installed Claude Code skills - install, update, rename, uninstall, and list skills from GitHub URLs. Use when the user wants to install a skill, update a skill, list installed skills, rename a skill, remove/delete/uninstall a skill, or provides a GitHub URL to a skills directory.

⭐5stars🔀1forks📁View on GitHub🕐Updated Jan 11, 2026

When & Why to Use This Skill

The Skill Manager for Claude Code is an essential utility designed to streamline the lifecycle of AI agent capabilities. It empowers users to seamlessly install, update, and organize custom skills directly from GitHub repositories. By integrating git-based version tracking and robust conflict resolution, it provides a professional-grade environment for managing the extensibility of Claude Code, ensuring that your agent's toolkit remains up-to-date and secure.

Use Cases

  • Installing new agent capabilities: Quickly add specialized functions to Claude Code by providing a GitHub URL to a skill directory.
  • Automated maintenance: Use bulk update commands to keep all installed skills synchronized with their latest upstream versions.
  • Safe code updates: Review diff summaries and manually accept or reject changes during updates to maintain control over the agent's behavior.
  • Workspace organization: Efficiently rename or uninstall skills to keep the Claude Code environment clean and tailored to specific project needs.
  • Version control for skills: Leverage the underlying git integration to track the history of skill modifications and resolve local conflicts.
nameskill-manager
descriptionManage your installed Claude Code skills - install, update, rename, uninstall, and list skills from GitHub URLs. Use when the user wants to install a skill, update a skill, list installed skills, rename a skill, remove/delete/uninstall a skill, or provides a GitHub URL to a skills directory.

Skill Manager

Manage Claude Code skills from GitHub - install, update, rename, uninstall, and list with version tracking.

Scripts

Script Purpose
install-skill.sh Install a skill from GitHub URL
update-skill.sh Update an installed skill from upstream
update-all-skills.sh Update all managed skills at once
list-skills.sh List all installed skills
uninstall-skill.sh Remove an installed skill
rename-skill.sh Rename an installed skill
skill-accept.sh Accept pending update changes
skill-reject.sh Reject pending update changes

Quick start

# Install a skill
~/.claude/skills/skill-manager/scripts/install-skill.sh "<github-url>"

# List installed skills
~/.claude/skills/skill-manager/scripts/list-skills.sh

# Update a skill
~/.claude/skills/skill-manager/scripts/update-skill.sh <skill-name>

# Update all managed skills
~/.claude/skills/skill-manager/scripts/update-all-skills.sh

Instructions for Claude

When user provides a GitHub URL to install

  1. Run the install script:
    ~/.claude/skills/skill-manager/scripts/install-skill.sh "<github-url>"
    
  2. If user wants a custom name, add --target <name>
  3. If conflict occurs, ask user: overwrite (--force) or rename (--target)?
  4. Tell user to restart Claude Code to load the new skill

When user asks to update a skill

  1. Run update:
    ~/.claude/skills/skill-manager/scripts/update-skill.sh <skill-name>
    
  2. If changes detected, show the diff summary to user
  3. Ask user to accept or reject
  4. Run the appropriate script:
    ~/.claude/skills/skill-manager/scripts/skill-accept.sh <skill-name>   # if accept
    ~/.claude/skills/skill-manager/scripts/skill-reject.sh <skill-name>  # if reject
    

When user asks to list/show installed skills

~/.claude/skills/skill-manager/scripts/list-skills.sh

When user asks to update all skills

~/.claude/skills/skill-manager/scripts/update-all-skills.sh

This script will:

  1. Check all managed skills for updates from their upstream sources
  2. Skip any skills with uncommitted local changes (reports them in summary)
  3. Report which skills have updates available (with pending changes to review)
  4. Report which skills are already up to date
  5. List any unmanaged skills that were skipped

If any skills have pending changes, ask the user if they want to accept or reject each one.

If any skills were skipped due to local changes, tell the user they need to commit or discard their changes first, then run update again.

When user asks to uninstall/remove a skill

~/.claude/skills/skill-manager/scripts/uninstall-skill.sh <skill-name>

When user asks to rename a skill

~/.claude/skills/skill-manager/scripts/rename-skill.sh <current-name> <new-name>

Conflict handling

  • Same source exists: Treated as update, show changes
  • Different source exists: Ask user to --force (overwrite) or --target <new-name> (install alongside)
  • Unmanaged skill exists: Ask user to --force to take over management
  • Local changes exist: Script prompts for confirmation before overwriting (or use --force to skip prompt)

Examples

Install from claude-code repo:

~/.claude/skills/skill-manager/scripts/install-skill.sh "https://github.com/anthropics/claude-code/tree/main/plugins/plugin-dev/skills/hook-development"

Install with custom name:

~/.claude/skills/skill-manager/scripts/install-skill.sh "https://github.com/metabase/metabase/tree/master/.claude/skills/clojure-write" --target metabase-clojure

Force overwrite:

~/.claude/skills/skill-manager/scripts/install-skill.sh "<url>" --force

Metadata file

Each installed skill has .skill-manager.json:

{
  "source_url": "https://github.com/owner/repo/tree/branch/path",
  "owner": "owner",
  "repo": "repo",
  "branch": "branch",
  "path": "path/to/skill"
}

Version tracking

  • Each skill is a local git repository
  • Initial install creates first commit
  • Updates stage changes for review before committing
  • Full git history of all changes

Requirements

  • curl - for downloading files
  • jq - for parsing JSON
  • git - for version tracking

Troubleshooting

API rate limit: GitHub allows 60 requests/hour unauthenticated. Wait or use authenticated requests.

Conflict detected: Use --force to overwrite or --target for different name.

No changes detected: Skill is already up to date with upstream.

Pending changes: Run skill-accept.sh or skill-reject.sh to resolve.

Local changes detected: The skill has uncommitted modifications. Either commit them (git add . && git commit -m "Local changes") or discard them (git checkout .) before updating.