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 (NEW format - recommended)
skilz install owner/repo/skill

# Examples
skilz install anthropics/claude-code/skill-development
skilz install anthropics/claude-code/hook-development
skilz install davila7/claude-code-templates/slack-gif-creator

# Legacy format (still supported)
skilz install owner_repo/skill

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
`--config <file>`	Custom config filename for universal agent (default: AGENTS.md)

pip install skilz

# Install for specific agent
skilz install anthropics/claude-code/skill-development --agent opencode

# Install at project level
skilz install anthropics/claude-code/skill-development --project

# Install specific version
skilz install anthropics/claude-code/skill-development --version abc1234

# Force reinstall
skilz install anthropics/claude-code/skill-development --force

# Custom config file (universal agent)
skilz install anthropics/claude-code/skill-development --agent universal --project --config GEMINI.md

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)
========================
  skill-development  anthropics/claude-code/skill-development  v1.0.0  abc1234
  hook-development   anthropics/claude-code/hook-development   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/claude-code/skill-development

# 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/claude-code/skill-development

# Remove from specific agent
skilz remove anthropics/claude-code/skill-development --agent opencode

# Remove project-level skill
skilz remove anthropics/claude-code/skill-development --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 skill-development

# Read from specific agent
skilz read skill-development --agent opencode

# Output raw content
skilz read skill-development --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