# localskills.sh

> A registry and CLI for creating, sharing, and installing AI agent skills across Cursor, Claude Code, Windsurf, Cline, and 5 more coding tools, with team controls, SSO, and SCIM built in.

localskills.sh is a platform for publishing, discovering, and installing AI agent skills — reusable instruction sets and context packages — across the most popular AI coding tools. Teams can create skills from the CLI, web editor, or REST API, then share them privately or publicly with version control and one-click rollback. The platform targets engineering teams that want consistent agent behavior across multiple tools without manually copying prompt files.

## What It Is

localskills.sh is an agent skill registry and distribution platform. A "skill" is a versioned artifact — a single file or a multi-file folder package — that tells an AI coding agent how to behave in a specific context: how to write Markdown, how to manage a CMS, how to run a review loop, and so on. The CLI (`npm i -g @localskills/cli`) installs skills directly into the configuration directories of supported tools, using symlink, copy, or embed-as-section strategies depending on the target.

## Supported Tools and Install Targets

The platform currently supports eight AI coding tools via a single CLI:

- **Cursor**
- **Claude Code**
- **Windsurf**
- **Cline**
- **GitHub Copilot**
- **Codex**
- **OpenCode**
- **Aider**

A single `localskills install` command resolves the correct install strategy per tool, and installs are tracked in a project config keyed by stable public IDs.

## Team Controls and Enterprise Identity

localskills.sh ships enterprise identity features under every plan, with no feature gates:

- **SAML 2.0 SSO** with Okta, Azure AD, and Google Workspace
- **SCIM 2.0 directory sync** with IdP group-to-team mapping
- **Email domain enforcement** for organization sign-in
- **Four built-in roles** plus custom roles with granular permissions
- **Folder-level ACLs** that restrict or grant access to subtrees per team or member

## Integrations and API

Beyond the CLI, localskills.sh exposes a full REST API with `lsk_` tokens (256-bit entropy, hashed at rest, revocable) designed for CI/CD pipelines. A push-only GitHub mirror syncs the full skill tree into a repo the team owns. An MCP server with OAuth and scoped grants lets agents search and install skills directly without human intervention.

## Analytics and Audit

The platform tracks installs by source (CLI, web, API) with 7- and 30-day trends per skill. An audit log with actor attribution covers publishes, rollbacks, SSO logins, SCIM provisioning, and token lifecycle events, with 90-day retention.

## Explore and Community Skills

The public explore page lists community-published skills with install commands. Skills in the registry at launch include writing humanizers, CMS managers, changelog updaters, Docker smoke tests, and tool-specific context packages. Each skill shows its version, author, and a one-line install command.

## Features
- Publish agent skills from CLI, REST API, or web editor
- Multi-file package skills from a folder (up to 500 files / 1 MB per version)
- Immutable version history with one-click rollback
- Supports Cursor, Claude Code, Windsurf, Cline, Copilot, Codex, OpenCode, and Aider
- Symlink, copy, or embed-as-section install strategies per tool
- Custom roles and folder-level access control
- SAML 2.0 SSO with Okta, Azure AD, Google Workspace
- SCIM 2.0 directory sync with IdP group-to-team mapping
- Email domain enforcement for organization sign-in
- Push-only GitHub mirror of full skill tree
- MCP server with OAuth and scoped grants
- lsk_ API tokens with 256-bit entropy, hashed at rest, revocable
- Download analytics with 7- and 30-day trends per skill
- Audit log with actor attribution and 90-day retention
- Public, private, and unlisted visibility per skill
- Community explore page with installable skills

## Integrations
Cursor, Claude Code, Windsurf, Cline, GitHub Copilot, Codex, OpenCode, Aider, GitHub, Okta, Azure AD, Google Workspace, MCP

## Platforms
WEB, CLI, API

## Pricing
Freemium — Free tier available with paid upgrades

## Links
- Website: https://localskills.sh
- Documentation: https://docs.localskills.sh/
- Repository: https://github.com/localskills-sh
- EveryDev.ai: https://www.everydev.ai/tools/localskills-sh
