CLI Reference

Overview

The Skillsy CLI is your primary tool for creating, testing, and deploying AI agent skills.

skillsy [OPTIONS] <COMMAND>

OPTIONS:
  --json         Output in JSON format (machine-readable)
  -v, --verbose  Verbose output
  -q, --quiet    Quiet mode
  -h, --help     Show help
  -V, --version  Show version

Commands

Factory (Skill Creation)

Command	Description	Example
`new <name>`	Create a new skill	`skillsy new my-skill --recipe basic`
`recipes`	List available templates	`skillsy recipes`
`compile <source>`	Compile skill from source	`skillsy compile ./my-skill --output ./out`

Quality (Testing & Validation)

Command	Description	Example
`lint [path]`	Check skill compliance	`skillsy lint ./my-skill --strict`
`test [path]`	Run harness tests	`skillsy test ./my-skill`

Distribution (Install & Deploy)

Command	Description	Example
`search [query]`	Search the registry	`skillsy search --category creative`
`list`	List installed skills	`skillsy list --scope project`
`install <source>`	Install a skill	`skillsy install ./local-skill --targets claude`
`link <path>`	Symlink local skill	`skillsy link ./my-skill --targets claude`
`remove <name>`	Remove a skill	`skillsy remove my-skill`

Governance (Security & Audit)

Command	Description	Example
`scan [path]`	Security scan	`skillsy scan ./my-skill`
`doctor`	Diagnose and fix issues	`skillsy doctor --fix`
`targets`	Show available targets	`skillsy targets`

Installation Sources

From Registry (Recommended)

# Search available skills
skillsy search --category creative

# Install from registry
skillsy install registry:algorithmic-art --targets claude

From GitHub

# Using owner/repo format
skillsy install anthropics/skills/skills/algorithmic-art --targets claude

# Using full URL
skillsy install https://github.com/anthropics/skills/tree/main/skills/algorithmic-art --targets claude

From Local Path

# Install from current directory
skillsy install ./my-skill --targets claude

# Install from absolute path
skillsy install /path/to/my-skill --targets claude

Target Platforms

Target	Project Directory	User Directory
Claude	`.claude/skills/`	`~/.claude/skills/`
Codex	`.codex/skills/`	`~/.codex/skills/public/`
Cursor	`.cursor/skills/`	`~/.cursor/skills/`

# Install to Claude
skillsy install ./my-skill --targets claude

# Install to multiple targets
skillsy install ./my-skill --targets claude,cursor

# Auto-detect installed tools
skillsy install ./my-skill

CLI Reference

On this page