Skillzwave Logo
Skillzwave

Installation

Skilz can be installed using pip, pipx, or directly from GitHub. Choose the method that best fits your workflow.

Requirements

  • Python 3.10+ — Skilz requires Python 3.10 or higher
  • Git — Required for cloning skill repositories
  • pip — Python package installer (comes with Python)

Installation Methods

From PyPI (Recommended)

The simplest way to install Skilz:

pip install skilz

Using pipx (Isolated Installation)

For an isolated installation that doesn't affect your system Python, use pipx: 

# Install pipx if you don't have it
pip install pipx
pipx ensurepath

# Install skilz
pipx install skilz

From GitHub (Latest Development)

Install the latest development version directly from GitHub:

pip install git+https://github.com/spillwave/skilz-cli.git

From Source (Development Setup)

For contributing or development:

git clone https://github.com/spillwave/skilz-cli.git
cd skilz-cli
pip install -e ".[dev]"

Verify Installation

After installation, verify Skilz is working:

pip install skilz
# Check version
skilz --version

# Show help
skilz --help

# List installed skills (should be empty initially)
skilz list

Updating Skilz

To update to the latest version:

# If installed via pip
pip install --upgrade skilz

# If installed via pipx
pipx upgrade skilz

Uninstalling

# If installed via pip
pip uninstall skilz

# If installed via pipx
pipx uninstall skilz

Note: Uninstalling Skilz does not remove installed skills. Skills remain in their installation directories.

Next Steps

Now that Skilz is installed: