Getting Started

localskills.sh is a platform for creating, sharing, and installing reusable agent skills and rules for AI coding tools. Publish a skill once and install it into Cursor, Claude Code, Codex CLI, Windsurf, Cline, GitHub Copilot, OpenCode, or Aider — the CLI writes each tool's native format.

localskills.sh in 45 seconds — install, publish, folders, and organization features.

1. Install the CLI

Install the localskills CLI globally via npm:

$ npm i -g @localskills/cli

Or use pnpm, yarn, or bun:

$ pnpm add -g @localskills/cli
$ yarn global add @localskills/cli
$ bun add -g @localskills/cli

Verify the installation:

$ localskills --version

2. Authenticate

Running localskills login starts a browser device-code flow — the CLI shows a verification code, opens your browser, and waits for approval:

$ localskills login

Your token is stored in ~/.localskills/config.json. For headless environments — CI servers, containers, or SSH sessions — create an API token in the dashboard and pass it directly:

$ localskills login --token lsk_your_token_here

Verify your identity at any time:

$ localskills whoami

3. Install 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 -t cursor,claude --project --symlink

Run localskills install without a slug to browse available skills interactively, or explore the public catalog at localskills.sh/explore.

The public Explore page listing community skills with search and tag filters
The Explore page — search and filter the public skill catalog.

4. Publish your own

Publish a single file, or a whole skill folder (a directory with a SKILL.md plus scripts and references) as a multi-file package:

$ localskills publish .claude/skills/my-skill --visibility public

Every publish creates a new version you can roll back from the dashboard. Skills default to private — visible only to your organization.

The dashboard Skills page with folders (one restricted, marked with a lock) and a skills table
Published skills land in your dashboard library, organized into folders.
Note: Prefer working in the browser? The dashboard's New Skill page accepts markdown directly or a drag-and-dropped folder/zip — no CLI required.