A command-line tool to simplify the installation and management of agent skills from GitHub repositories.

• Installing agent skills is cumbersome (requires git clone for each skill and creating symbolic links)
• Reusing skills across multiple agents is tedious (requires creating symbolic links in each agent's directory)

Simplify the installation and management of agent skills.

• download: Clone a GitHub repository (e.g., github.com/tsubasaogawa/semantic-commit-helper) to ~/.local/src/manage-agent-skills
• install : Create symbolic links to cloned repositories in the specified agent's skill directory
  • Agent skill directory list is managed in config.toml
• list: Display a list of skills cloned under ~/.local/src/manage-agent-skills

• Git

Download the latest release binary for your platform from the releases page.

Extract the archive and move the binary to your PATH:

# Example for Linux/macOS
tar xzf manage-agent-skills_*.tar.gz
sudo mv manage-agent-skills /usr/local/bin/

git clone https://github.com/tsubasaogawa/manage-agent-skills.git
cd manage-agent-skills
go build -o manage-agent-skills .

Optionally, move the binary to your PATH:

sudo mv manage-agent-skills /usr/local/bin/

Or install with go install:

go install github.com/tsubasaogawa/manage-agent-skills@latest

The repository includes a default configuration file (config.toml) with pre-configured agent skill directories for common AI assistants:

[agents]
claude = "~/.claude/skills"
codex = "~/.codex/skills"
gemini = "~/.gemini/skills"
copilot = "~/.copilot/skills"

You can customize this file or create your own at ~/.config/manage-agent-skills/config.toml. Each entry maps an agent name to its skills directory path.

Download a skill from a GitHub repository (for example: https://github.com/tsubasaogawa/semantic-commit-helper skill)

manage-agent-skills download github.com/tsubasaogawa/semantic-commit-helper

This clones the repository to ~/.local/src/manage-agent-skills/semantic-commit-helper.

Display all downloaded skills:

manage-agent-skills list

Output:

Downloaded skills:
  - semantic-commit-helper
  - another-skill

Install all downloaded skills to a specific agent:

manage-agent-skills install claude

This creates symbolic links in the agent's skill directory (as defined in config.toml) for all downloaded skills.

Output:

  Installed semantic-commit-helper
  Installed another-skill
Successfully installed skills to agent 'claude'

Get help for any command:

manage-agent-skills --help
manage-agent-skills download --help

~/.local/src/manage-agent-skills/
├── semantic-commit-helper/   # Downloaded skill repository
├── another-skill/             # Downloaded skill repository
└── ...

~/.config/manage-agent-skills/
└── config.toml                # Configuration file

~/.claude/skills/
├── semantic-commit-helper -> ~/.local/src/manage-agent-skills/semantic-commit-helper
├── another-skill -> ~/.local/src/manage-agent-skills/another-skill
└── ...

go test ./...

go build -o manage-agent-skills .

This project uses GoReleaser to automate the release process.

To create a new release:

1. Create and push a new tag:

   git tag -a v0.1.0 -m "Release v0.1.0"
   git push origin v0.1.0

2. GitHub Actions will automatically:

   • Build binaries for multiple platforms (Linux, macOS, Windows)
   • Generate checksums
   • Create a GitHub release with the binaries and changelog

To test the release process locally without publishing:

goreleaser release --snapshot --clean

See LICENSE file.