Command Reference

Complete reference for all Skilz CLI commands. Each command includes usage examples and available options.

Remember: Install Skilz first with pip install skilz before running these commands.

skilz install

Install a skill from the registry or marketplace.

pip install skilz

# Basic usage
skilz install owner_repo/skill-name

# Examples
skilz install anthropics_skills/theme-factory
skilz install anthropics_skills/algorithmic-art

Options

Option	Description
`--agent <name>`	Target agent (claude, opencode, codex, gemini, etc.)
`--project`	Install at project level instead of user level
`--version <sha>`	Install specific commit SHA
`--force`	Overwrite existing installation
`--verbose`	Show detailed output

pip install skilz

# Install for specific agent
skilz install anthropics_skills/theme-factory --agent opencode

# Install at project level
skilz install anthropics_skills/theme-factory --project

# Install specific version
skilz install anthropics_skills/theme-factory --version abc1234

# Force reinstall
skilz install anthropics_skills/theme-factory --force

skilz list

Show all installed skills with their versions and status.

pip install skilz

# List all user-level skills
skilz list

# List project-level skills
skilz list --project

# List skills for specific agent
skilz list --agent opencode

# Output as JSON
skilz list --json

Output Example

Installed Skills (claude)
========================
  theme-factory     anthropics_skills/theme-factory     v1.0.0  abc1234
  algorithmic-art   anthropics_skills/algorithmic-art   v1.0.0  def5678

skilz update

Update installed skills to their latest versions.

pip install skilz

# Update all skills
skilz update

# Update specific skill
skilz update anthropics_skills/theme-factory

# Update for specific agent
skilz update --agent opencode

# Dry run (show what would be updated)
skilz update --dry-run

skilz remove

Remove an installed skill.

pip install skilz

# Remove a skill
skilz remove anthropics_skills/theme-factory

# Remove from specific agent
skilz remove anthropics_skills/theme-factory --agent opencode

# Remove project-level skill
skilz remove anthropics_skills/theme-factory --project

skilz read

Read and display skill content. Useful for agents that don't natively load skills or for debugging.

pip install skilz

# Read skill content
skilz read theme-factory

# Read from specific agent
skilz read theme-factory --agent opencode

# Output raw content
skilz read theme-factory --raw

skilz search

Search for skills in the registry.

pip install skilz

# Search by keyword
skilz search theme

# Search with filters
skilz search "code review" --category technical

Global Options

These options work with all commands:

Option	Description
`--help`	Show help for command
`--version`	Show Skilz version
`--verbose`	Show detailed output
`--quiet`	Suppress non-error output

pip install skilz

# Get help for any command
skilz install --help
skilz list --help
skilz update --help