skillup 0.3.2

A minimal CLI to manage agent skills from GitHub releases.

skillup

A minimal, user-friendly Python CLI to manage agent skills from GitHub releases or branches. It installs skills to both ~/.agents/skills and ~/.claude/skills for seamless integration across platforms.

Features

• Interactive Installation: Select specific skills to add from any GitHub repository.
• Multi-Repo Support: Manage skills from multiple repositories independently.
• Lock File State: Tracks installed sources (release tags or branches), pinned commit SHAs, and skills in ~/.agents/skills.lock.json for reproducibility.
• Automated Updates: Easily upgrade all or specific repositories to their latest GitHub release or tracked branch head.
• Smart Caching: Downloads are cached in a temporary directory (TEMP or /tmp) to avoid redundant network usage. Can be overridden with SKILLUP_CACHE_DIR.
• GitHub CLI Integration: Uses the gh tool for fast downloads if available, with a reliable requests fallback.

Installation

Install using pip or uv:

pip install skillup
# or
uv tool install skillup

Usage

1. Add Skills

Interactively select skills to add from a GitHub repository's latest release:

skillup add google/gemini-cli-skills

If a repository has no releases, the CLI automatically falls back to the main branch. You can also install directly from a branch:

skillup add anthropics/skills --branch main --skill pdf

2. Remove Skills

Interactively select installed skills to remove from your system:

skillup remove

3. Update Skills

Update all installed skills to their latest tracked versions:

skillup update

Or update a specific repository:

skillup update --repo google/gemini-cli-skills

4. Sync Skills

Install all skills as defined in the lock file using the pinned commit SHAs (useful for setting up a new machine):

skillup sync

5. Migrate from NPX Skills CLI

If you already have a skills-lock.json in your repository root, you can import it into the skillup lock format. The latest release or branch commit is resolved from GitHub at migration time.

skillup migrate

A custom path can be provided if the file is elsewhere:

skillup migrate path/to/skills-lock.json

Skill Definition

A folder is recognized as a valid skill if it resides within a skills/ directory at the repository root and contains a SKILL.md file.

Development

This project uses uv for dependency management.

# Install dependencies
uv sync

# Run locally
uv run skillup --help

# Run tests
uv run pytest

# Type check
uv run pyright skillup

License

MIT