skillpkg

English | Chinese | Japanese | French

A TUI package manager for Claude Code skills.

Features

• Browse and install skills from registry
• Manage installed skill packages
• Switch between versions (git commits)
• Per-project installation (installs to .claude/skills/)

Installation

cargo install --git https://github.com/mofa-org/skillpkg

Or build from source:

git clone https://github.com/mofa-org/skillpkg
cd skillpkg
cargo build --release

Usage

Run skillpkg in your project directory:

cd /path/to/your-project
skillpkg

Keyboard Controls

Main Menu:

• Up/Down or j/k - Navigate
• Enter - Select
• q or Ctrl+C - Quit

Browse Registry:

• Up/Down - Navigate packages
• Enter - View package details
• i - Install package
• q - Back

Installed Packages:

• Up/Down - Navigate
• Enter - View details
• u - Update package
• d - Uninstall package
• q - Back

Version Select:

• Up/Down - Navigate commits
• Enter - Switch to selected version
• q - Back

Package Manifest Format

Packages are defined in JSON files in the packages/ directory:

{
  "name": "package-name",
  "description": "Description of the skill package",
  "source": "https://github.com/owner/repo/tree/branch/path/to/skills",
  "auto_prefix": true
}

• name: Package identifier (used as prefix if auto_prefix is true)
• description: Human-readable description
• source: GitHub URL pointing to the skills root directory (repo root or subdirectory like https://github.com/ZhangHanDong/makepad-skills/tree/main/skills, must be HTTPS URL, not SSH)
• auto_prefix: If true, installed skill directories are prefixed with the package name

Contributing

To add a new skill package, please submit a PR. We only accept new skills through PRs so they can be reviewed and indexed.

1. Fork this repo and create a branch.
2. Add a new manifest JSON file under packages/ (unique name, accurate source, clear description).
3. Verify the manifest follows the format above.
4. Open a PR with a brief summary of the skill package.

Local State

skillpkg stores installation state in .claude/skills/.installed.json:

{
  "packages": {
    "package-name": {
      "source": "https://github.com/...",
      "commit": "abc1234...",
      "auto_prefix": true,
      "installed_at": "2025-01-16T00:00:00Z",
      "skills": ["package-name-skill1", "package-name-skill2"]
    }
  }
}

License

Apache-2.0