Documentation

Everything you need to get started with SkillX.

Getting Started

1. Install the CLI

Install SkillX globally or run it directly with npx.

$npm install -g skillx-sh

or use without installing:

$npx skillx-sh --help

2. Search for Skills

Find skills using semantic search. SkillX understands natural language queries.

$skillx search "deploy to cloudflare"

3. Use a Skill

View skill details and get the install command for your AI agent.

$skillx use cloudflare-workers

4. Configure API Key (Optional)

Set up an API key to report usage stats and unlock authenticated features. Generate your key at Settings.

$skillx config set-key

Available Commands

skillx search <query>

Search for skills in the marketplace using natural language. Results show name, category, rating, and description.

$skillx search "react authentication"

skillx use <identifier>

Smart skill lookup — supports author/skill, org/repo/skill, slug, or keyword search. Auto-registers from GitHub if not found.

Flags

-r, --rawOutput raw content only (for piping to files)
-s, --searchForce search mode regardless of identifier format
$skillx use alinaqi/code-review

skillx find <query>

Search and use a skill in one command. Shows numbered results and lets you pick one to view details.

$skillx find "deploy to cloudflare"

skillx report <slug> <outcome>

Report skill usage outcome. Requires an API key. Outcomes: success, failure, or partial.

Flags

-m, --model <model>AI model used (e.g., claude-sonnet-4)
-d, --duration <ms>Execution duration in milliseconds
$skillx report cloudflare-workers success --model claude-sonnet-4 --duration 1200

skillx config

Manage CLI configuration including API key and base URL.

Subcommands

set-keySet your SkillX API key interactively
set-url <url>Set custom API base URL (default: https://skillx.sh)
showDisplay current configuration

Environment Variables

You can also configure SkillX via environment variables.

SKILLX_API_KEYAPI key (overrides config file)
SKILLX_BASE_URLCustom API base URL