# localskills.sh > localskills.sh is a platform for creating, sharing, and installing reusable agent skills and rules for AI coding tools. Publish a skill once as a plain-Markdown package (a folder with a root SKILL.md), then install it into Cursor, Claude Code, Codex CLI, Windsurf, Cline, GitHub Copilot, OpenCode, or Aider with one CLI command. Key facts: - CLI: install with `npm i -g @localskills/cli`, then `localskills install ` to install a skill and `localskills publish [path]` to publish one. The CLI supports 8 AI coding tools and three install methods (symlink, copy, or embed as a managed section). - Every skill is a versioned Markdown package with a root SKILL.md; each update creates a new version that can be rolled back. Visibility is public, private (organization-only), or unlisted (direct link). - Skills live at canonical URLs of the form `https://localskills.sh/{tenant}/{folder-path}/{skill-slug}`; short links of the form `https://localskills.sh/s/{publicId}` permanently redirect there. - MCP server: AI agents can search, read, and publish your teams' skills directly over the Model Context Protocol — including fetching bundled package files via signed download URLs or chunked base64. Streamable HTTP endpoint: `https://localskills.sh/mcp/mcp`, OAuth 2.1 required (tokens are bound to one chosen organization). Works with Claude Code, claude.ai, Claude Desktop, Cursor, Codex CLI, Windsurf, VS Code, Cline, and opencode. - REST API: base URL `https://localskills.sh/api`, authenticated by session cookie or Bearer API token (`lsk_` personal / `lskt_` team tokens). Machine-readable OpenAPI 3.1 spec at https://localskills.sh/openapi.yaml. - For teams and enterprises: organizations with teams and custom roles, folder-based access control, automatically provisioned Personal Workspaces for each member, GitHub repository sync, CI/CD publishing via OIDC (no stored secrets), SAML 2.0 SSO, SCIM 2.0 provisioning, download analytics, and 90-day audit logs. ## Documentation - [Getting Started](https://docs.localskills.sh/getting-started/): Install the CLI, authenticate, and install your first skill in minutes. - [CLI Reference](https://docs.localskills.sh/cli/): Complete reference for the localskills CLI — install, publish, pull, uninstall, and list commands. - [MCP Server](https://docs.localskills.sh/mcp/): Connect AI agents directly via the Model Context Protocol — endpoint, OAuth scopes, up to eleven tools, and setup for Claude Code, claude.ai, Cursor, Codex CLI, Windsurf, VS Code, and more. - [Skills](https://docs.localskills.sh/skills/): Types, text and package formats, visibility, versioning, supported platforms, and install methods. - [Folders & Access Control](https://docs.localskills.sh/folders/): Organize skills into a folder tree and restrict folders to specific teams and members. - [Personal Workspaces](https://docs.localskills.sh/personal-workspaces/): Provision one managed private skill workspace per organization member, with semantic web, CLI, API, and MCP destinations. - [Anonymous Sharing](https://docs.localskills.sh/sharing/): Share a skill without an account — a pastebin for agent skills, keyed to a local Ed25519 identity. - [Organizations & Teams](https://docs.localskills.sh/teams/): Create an organization, invite members, and group them into role-carrying teams. - [Roles & Permissions](https://docs.localskills.sh/roles/): Built-in roles plus custom roles with granular permissions across skills, folders, and settings. - [GitHub Sync](https://docs.localskills.sh/github-sync/): Mirror your organization's skill library to a GitHub repository, folder structure included. - [CI/CD & OIDC](https://docs.localskills.sh/cicd/): Publish from GitHub Actions and GitLab CI with OIDC token exchange — no stored secrets. - [SSO / SAML 2.0](https://docs.localskills.sh/sso/): Configure SAML 2.0 Single Sign-On with Okta, Azure AD, Google Workspace, and other identity providers. - [SCIM 2.0](https://docs.localskills.sh/scim/): Automate user and group provisioning with SCIM 2.0 directory sync from your identity provider. - [API Tokens](https://docs.localskills.sh/api-tokens/): Generate and manage API tokens for CI/CD pipelines, headless CLI auth, and programmatic access. - [Analytics](https://docs.localskills.sh/analytics/): Track skill downloads by source with privacy-preserving analytics and daily trend breakdowns. - [Audit Log](https://docs.localskills.sh/audit-log/): User and organization audit logs with 90-day retention covering all platform actions. - [API Reference](https://docs.localskills.sh/api-reference/): REST API authentication, endpoints for skills, teams, SSO, SCIM, and CLI auth. - [Security](https://docs.localskills.sh/security/): Rate limiting, security headers, authentication security, and content limits. ## API - [OpenAPI 3.1 specification](https://localskills.sh/openapi.yaml): Machine-readable spec covering every REST endpoint, authentication mechanism, and response schema. - [Interactive API docs](https://localskills.sh/api-docs): Browsable API reference rendered from the OpenAPI spec. ## Optional - [Full documentation as a single file](https://docs.localskills.sh/llms-full.txt): Every documentation page concatenated into one plain-text file for LLM consumption, generated on each docs deploy. - [Documentation index](https://docs.localskills.sh/llms.txt): The docs site's own link index, generated from its content collection. - [Explore](https://localskills.sh/explore): Browse public skills in the registry. - [Features](https://localskills.sh/features): Feature overview — publish, share, install, teams, analytics, tokens, SSO/SCIM, audit log. - [Blog](https://localskills.sh/blog): Guides and comparisons on agent skills, AI coding rules, and team workflows. - [What Are Agent Skills?](https://localskills.sh/blog/what-are-agent-skills): Introduction to the agent-skill concept. - [Publish Your First Agent Skill in Under 5 Minutes](https://localskills.sh/blog/publish-your-first-skill): Step-by-step publishing tutorial. - [One Rulebook for All Your AI Coding Tools](https://localskills.sh/blog/ai-coding-rules-across-tools): Write rules once, install into every tool. - [Publish AI Skills from CI/CD with OIDC](https://localskills.sh/blog/cicd-oidc-publish-skills): Secretless publishing from GitHub Actions and GitLab CI. - [Setting Up SSO for Your AI Skills Registry](https://localskills.sh/blog/sso-saml-setup-guide): SAML 2.0 setup with Okta, Entra ID, or Google Workspace. - [Vulnerability disclosure policy](https://localskills.sh/security): How to report security issues.