CLI Reference

The Skillsmith CLI (skillsmith or sklx) provides commands for skill discovery, installation, and management.

Installation

# Global installation
npm install -g @skillsmith/cli

# Or use npx for one-off commands
npx @skillsmith/cli <command>

Core Commands

search

Search for skills in the Skillsmith registry.

skillsmith search <query> [options]

# Examples
skillsmith search testing
skillsmith search git --tier verified
skillsmith search --category devops --limit 20

Options

Option	Description	Default
`--tier`	Filter by trust tier (verified, community, experimental)	all
`--category`	Filter by category	all
`--min-score`	Minimum quality score (0-100)	0
`--limit`	Maximum number of results	10
`--json`	Output results as JSON	false

install

Install a skill to your local environment.

skillsmith install <skill-id> [options]

# Examples
skillsmith install jest-helper
skillsmith install community/git-commit
skillsmith install anthropic/official-skill --force

Options

Option	Description	Default
`--path`	Installation directory	~/.claude/skills/
`--force`	Overwrite existing installation	false
`--dry-run`	Preview without installing	false

uninstall

Remove an installed skill.

skillsmith uninstall <skill-id> [options]

# Examples
skillsmith uninstall jest-helper
skillsmith uninstall community/git-commit --confirm

Options

Option	Description	Default
`--confirm`	Skip confirmation prompt	false

info

Get detailed information about a skill.

skillsmith info <skill-id>

# Examples
skillsmith info jest-helper
skillsmith info community/git-commit --json

list

List installed skills.

skillsmith list [options]

# Examples
skillsmith list
skillsmith list --json
skillsmith list --path ~/custom/skills

compare

Compare multiple skills side-by-side.

skillsmith compare <skill-id> <skill-id> [...]

# Examples
skillsmith compare jest-helper vitest-helper
skillsmith compare skill-a skill-b skill-c --json

recommend

Get personalized skill recommendations.

skillsmith recommend [options]

# Examples
skillsmith recommend
skillsmith recommend --context react
skillsmith recommend --analyze ./package.json

Options

Option	Description
`--context`	Technology context (react, node, python, etc.)
`--analyze`	Analyze a file for context
`--limit`	Maximum recommendations

Author Commands

Commands for skill authoring and development.

author subagent

Generate a companion subagent for a skill.

skillsmith author subagent <skill-path> [options]

# Examples
skillsmith author subagent ./my-skill
skillsmith author subagent ./my-skill --output ./agents

Options

Option	Description
`--output, -o`	Output directory for generated subagent
`--tools`	Override detected tools (comma-separated)
`--model`	Model to use (sonnet, opus, haiku)
`--skip-claude-md`	Skip CLAUDE.md delegation snippet

author transform

Transform an existing skill to add subagent support.

skillsmith author transform <skill-path> [options]

# Examples
skillsmith author transform ./my-skill
skillsmith author transform ./skills --batch --dry-run

Options

Option	Description
`--dry-run`	Preview changes without writing
`--batch`	Process multiple skills in directory
`--tools`	Override detected tools
`--model`	Model to use

validate

Validate a skill's structure and metadata.

skillsmith validate <skill-path>

# Examples
skillsmith validate ./my-skill
skillsmith validate ~/.claude/skills/jest-helper

Global Options

Option	Description
`--version`	Show CLI version
`--help`	Show help for command
`--verbose`	Enable verbose output
`--quiet`	Suppress non-essential output

Configuration

The CLI can be configured via environment variables or a config file at ~/.skillsmithrc:

# ~/.skillsmithrc
{
  "defaultTier": "community",
  "installPath": "~/.claude/skills",
  "registry": "https://registry.skillsmith.dev"
}

Environment Variables

Variable	Description
`SKILLSMITH_REGISTRY`	Custom registry URL
`SKILLSMITH_INSTALL_PATH`	Default installation path
`SKILLSMITH_API_KEY`	API key for authenticated requests

Troubleshooting

Common Issues

Permission Denied

If you see permission errors when installing globally, try using npx @skillsmith/cli instead, or fix npm permissions.

Skill Not Found

Ensure you're using the correct skill ID format (author/name). Use skillsmith search to find available skills.