Getting Started

This guide walks you through installing the CLI, finding a skill, and creating your first one.

Install the CLI

# npm (recommended)
npm install -g siteskills

# Homebrew
brew install siteskills/tap/siteskills

# Standalone binary
curl -fsSL https://siteskills.ai/install.sh | sh

Authenticate

siteskills login

Choose API key (from siteskills.ai/settings/api-keys) or browser OAuth.

Browse Skills

Search the marketplace from your terminal:

siteskills search "amazon cart"

Filter by category, agent, or pricing:

siteskills search "checkout" --category e-commerce --agent claude-cowork --free

Get detailed info on a specific skill:

siteskills info amazon-add-to-cart

Install a Skill

siteskills install amazon-add-to-cart

The CLI auto-detects your agent environment and installs to the correct directory:

Agent	Install Path
Claude Code / Cowork	.claude/skills/<skill-name>/
Browser Use	./skills/<skill-name>/
Stagehand	./stagehand/<skill-name>/
Custom	./siteskills/<skill-name>/

Override with --dir:

siteskills install amazon-add-to-cart --dir ./my-skills/

Create Your First Skill

Scaffold a new skill:

siteskills init

The CLI prompts you for:

• Skill name (slug)
• Display name
• Target domain(s)
• Category
• Difficulty
• Auth requirements

This creates a ready-to-edit skill directory:

my-awesome-skill/
├── SKILL.md           # Edit with your navigation steps
├── siteskills.json    # Pre-filled metadata
├── README.md          # Documentation template
└── tests/
    └── test-basic.json

Validate & Publish

Check your skill locally:

siteskills validate ./my-awesome-skill/

When it passes, publish to the marketplace:

siteskills publish ./my-awesome-skill/

Your skill enters the review pipeline. You will receive an email when it is approved.

Next Steps

• Read the Template Standard to understand every field
• Follow the Creating Skills tutorial for a detailed walkthrough
• Set up Agent Integration for your preferred agent