GetSkill CLI (gskill)

Command-line tool for discovering, installing, and publishing skills for AI coding agents.

getskill.net

Installation

npm install -g gskill

Requires Node.js 18 or later.

Quick Start

# Search for skills
gskill search "code review"

# Install a skill
gskill install @anthropic/code-review

# Show skill details
gskill info @anthropic/code-review

# List installed skills
gskill list

# Update installed skills
gskill update

Commands

gskill search <query> [--limit <n>]

Search the GetSkill registry for skills.

gskill search "docker"
gskill search "typescript" --limit 5

gskill install @<owner>/<slug> [--tool <name>] [--dry-run]

Install a skill from the registry. By default installs to Claude Code.

# Install for Claude Code (default)
gskill install @anthropic/code-review

# Install for a different tool
gskill install @anthropic/code-review --tool cursor
gskill install @anthropic/code-review --tool windsurf
gskill install @anthropic/code-review --tool cline

# Validate without installing
gskill install @anthropic/code-review --dry-run

Supported tools: claude-code (default), cursor, windsurf, cline

gskill info @<owner>/<slug>

View detailed information about a skill.

gskill info @anthropic/code-review

Shows name, version, description, platforms, install count, and the install command.

gskill list [--outdated]

List skills installed in the current project.

gskill list
gskill list --outdated   # check registry for newer versions
gskill list --global    # list globally installed skills

Shows skill name, version, and whether an update is available.

gskill login

Authenticate with GetSkill via browser OAuth.

gskill login

After authentication, your session is stored in ~/.config/gskill/config.json.

gskill publish <repo-url> [--dry-run] [--yes]

Publish a skill to GetSkill from a GitHub or GitLab repository.

# Preview what will be published (validates SKILL.md exists)
gskill publish https://github.com/owner/repo --dry-run

# Publish (asks for confirmation)
gskill publish https://github.com/owner/repo

# Publish without confirmation
gskill publish https://github.com/owner/repo --yes

gskill update [--global]

Update all installed skills to their latest versions.

gskill update
gskill update --global

gskill whoami

Show the currently authenticated user.

gskill whoami

gskill logout

Sign out and clear stored credentials.

gskill logout

Configuration

Environment Variables

| Variable | Default | Description | |----------|---------|-------------| | GETSKILL_API_URL | https://getskill.net/api | API base URL |

Skill Installation Paths

Skills are stored in a canonical location (~/.agents/skills/) with symlinks to each tool:

| Tool | Path | |------|------| | Claude Code | ~/.claude/skills/ | | Cursor | ~/.cursor/skills/ | | Windsurf | ~/.windsurf/skills/ | | Cline | ~/.cline/skills/ |

Development

# Build
bun run build

# Type check
bun run typecheck

# Lint
bun run lint

License

MIT