Getting Started

localskills.sh is a platform for creating, sharing, and installing reusable agent skills and rules for AI coding tools. Skills are portable instructions that work across Cursor, Claude Code, Codex, Windsurf, Cline, GitHub Copilot, OpenCode, and Aider.

Install the CLI

Install the localskills CLI globally via npm:

$ npm i -g @localskills/cli

Verify the installation:

$ localskills --version

Authenticate

Running localskills login opens your browser with a device code for authentication:

$ localskills login

Your token is stored in ~/.localskills/config.json. For headless environments – CI servers, containers, or SSH sessions – pass a token directly:

$ localskills login --token lsk_your_token_here

Verify your identity at any time:

$ localskills whoami

Your first skill

Install a skill by slug. The CLI walks you through platform selection, scope (global or project), and install method:

$ localskills install my-skill

Skip the prompts by passing flags directly:

$ localskills install my-skill --target cursor claude --project --symlink

Run localskills install without a slug to browse available skills interactively.