llms.txt
# 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 <slug>` 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.
