Skip to content

Home

Jump to bottom
Rick Hightower edited this page Jan 29, 2026 · 2 revisions

Skilz

The universal package manager for AI skills.

PyPI version Python 3.10+ License: MIT

Wiki Navigation

Documentation Description
User-Manual Complete CLI reference (v1.10.0)
Comprehensive-User-Guide In-depth agent and workflow guide
Supported-Agents Full agent support matrix (30+ agents)
Gemini-Migration-Guide Gemini CLI migration guide
Universal-Agent-Guide Multi-agent configuration guide
Deploy-PyPI PyPI deployment documentation
Changelog Version history
Architectural-Decisions ADRs
Key-Facts Critical project information
Known-Issues Bugs and workarounds

Skilz installs and manages AI skills (agents and tools) across multiple AI coding assistants. Think npm install or pip install, but for skills.

Skilz follows the agentskills.io standard and supports the AGENTS.md ecosystem.

Built by Spillwave — Leaders in agentic software development.

Browse skills at Skillzwave.ai — The largest agent and agent skills marketplace.

Why Skilz?

Today, installing AI skills requires manual file copying, marketplace browsing, or plugin commands that vary by tool. Skilz unifies this experience:

  • One command installs any skill from any Git repository
  • Works everywhere — Claude Code, OpenCode, and more coming
  • Reproducible — pin skills to specific commits for consistent behavior
  • Auditable — manifest files track what's installed and where it came from

Installation

From PyPI (Recommended)

pip install skilz

From GitHub

# Install directly from GitHub (latest development version)
pip install git+https://github.com/spillwave/skilz-cli.git

# Or clone and install
git clone https://github.com/spillwave/skilz-cli.git
cd skilz-cli
pip install .

Development Setup

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

For detailed usage instructions, see the User-Manual.

Quick Start

# Install a skill from the marketplace using NEW format (defaults to Claude Code, user-level)
skilz install anthropics/skills/algorithmic-art

# Install using LEGACY format (backwards compatible)
skilz install anthropics_skills/algorithmic-art

# Install directly from GitHub URL (NEW in 1.5 - no -g flag needed)
skilz install https://github.com/owner/repo

# Install for a specific agent using NEW format
skilz install anthropics/skills/brand-guidelines --agent opencode

# Install at project level (for sandboxed agents)
skilz install anthropics/skills/frontend-design --agent copilot -p

# Gemini CLI native support (NEW in 1.7 - requires experimental.skills plugin)
skilz install anthropics/skills/pdf-reader --agent gemini --project

# Legacy Gemini workflow (NEW in 1.7 - for users without experimental.skills)
skilz install anthropics/skills/pdf-reader --agent universal --project --config GEMINI.md

# Universal agent with custom config (NEW in 1.7)
skilz install anthropics/skills/excel --agent universal --project --config CUSTOM.md

# List installed skills (or use alias: skilz ls)
skilz list

# Search for skills on GitHub (NEW in 1.5)
skilz search excel
skilz search pdf --limit 5

# Visit a skill's GitHub page (NEW in 1.5)
skilz visit anthropics/skills

# Read skill content (for agents without native skill loading)
skilz read algorithmic-art

# Update all skills to latest registry versions
skilz update

# Uninstall a skill (or use alias: skilz rm)
skilz uninstall anthropics/skills/algorithmic-art

Skill ID Formats

Skilz supports two skill ID formats:

  • NEW Format (Recommended): owner/repo/skill-name — e.g., anthropics/skills/theme-factory
  • LEGACY Format: owner_repo/skill-name — e.g., anthropics_skills/theme-factory

Both formats work identically. Use whichever you prefer!

Each install command:

  1. Resolves the skill from the registry
  2. Clones the repository (or reuses an existing clone)
  3. Checks out the pinned commit
  4. Copies the skill to the appropriate location
  5. Writes a manifest for tracking

User Journey

  1. Browse skills at skillzwave.ai
  2. Copy the install command from the skill page
  3. Run it locally

Example:

The skill page for Theme Factory shows:

skilz install anthropics_skills/theme-factory

The string anthropics_skills/theme-factory is the Skill ID. Skilz supports two formats:

  • NEW Format (Recommended): owner/repo/skill-name — e.g., anthropics/skills/theme-factory
  • LEGACY Format: owner_repo/skill-name — e.g., anthropics_skills/theme-factory (underscores separate owner and repo)

Both formats work identically and resolve to the same skill. The NEW format is more intuitive and matches GitHub repository structure.

Supported Agents

Skilz supports 30+ AI coding agents from the AGENTS.md ecosystem, including Claude Code, OpenAI Codex, Gemini CLI, GitHub Copilot, Cursor, Aider, Windsurf, Zed AI, RooCode, Devin, Google Antigravity, Qwen Code, OpenHands, Cline, Goose, and many more.

For the complete agent support matrix, see Supported-Agents.

Skill Support Levels

Level Description Example Agents
Full Support Native skill directories at user or project level Claude Code, OpenCode, Codex
Project Support Project-level installation via --project Cursor, Aider, Gemini CLI
Universal Any AGENTS.md-compatible agent via --agent universal Ona, Amp, Devin, Factory, Jules

CLI Reference

skilz install <skill-id>

Install a skill from the registry or marketplace.

skilz install anthropics_skills/theme-factory           # Auto-detect agent
skilz install anthropics_skills/theme-factory --agent claude
skilz install anthropics_skills/theme-factory --agent opencode
skilz install anthropics_skills/theme-factory --project # Project-level

skilz list

Show all installed skills with their versions and status.

skilz list                   # All user-level skills
skilz list --project         # Project-level skills
skilz list --agent claude    # Only Claude Code skills
skilz list --json            # Output as JSON

skilz update [skill-id]

Update installed skills to match registry versions.

skilz update                                    # Update all skills
skilz update anthropics_skills/algorithmic-art  # Update specific skill
skilz update --dry-run                          # Show what would be updated
skilz update --project                          # Update project-level skills

skilz uninstall <skill-id> (alias: rm)

Uninstall an installed skill.

skilz uninstall anthropics_skills/theme-factory    # Prompts for confirmation
skilz uninstall anthropics_skills/theme-factory -y # Skip confirmation
skilz rm theme-factory --project                   # Remove by name (using alias)

skilz search <query> (NEW in 1.5)

Search GitHub for available skills.

skilz search excel              # Search for excel-related skills
skilz search pdf --limit 5      # Limit to 5 results
skilz search "data" --json      # JSON output for scripting

skilz visit <source> (NEW in 1.5)

Open a skill's GitHub page in your default browser.

skilz visit anthropics/skills          # Opens repo page
skilz visit anthropics/skills/excel    # Opens skill directory
skilz visit https://github.com/...     # Opens full URL

Command Aliases

For Unix-like familiarity:

Original Alias
skilz list skilz ls
skilz uninstall skilz rm

For complete documentation including troubleshooting and advanced examples, see the User-Manual.

Related Projects

Vision

Skilz brings skills to all AI agents via the AGENTS.md standard.

Skilz follows the agentskills.io standard for skill format and supports the full AGENTS.md ecosystem of 22+ coding agents.

For Claude Code users:

  • Install skills from any GitHub repository
  • Use private repos and local paths
  • Share skills across multiple agents
  • Version-control skills in your own repositories

For other agents:

  • Universal access to Claude's skills ecosystem via AGENTS.md
  • Use Anthropic marketplace skills via GitHub
  • Progressive disclosure — load skills on demand

Get started: Browse available skills at skillzwave.ai and install with a single command.

For the full README including development instructions, registry format, and roadmap, see the GitHub repository.

Clone this wiki locally