# skillshare

> One source of truth for AI CLI skills. Sync everywhere with one command.

## Overview

- [Introduction](https://skillshare.runkids.cc/docs/): skillshare is a CLI tool that syncs AI CLI skills from a single source to all your AI coding assistants.

## Learn

- [Getting Started](https://skillshare.runkids.cc/docs/getting-started/): skillshare keeps one source directory in sync with every AI CLI's skill directory on your machine.
- [First Sync](https://skillshare.runkids.cc/docs/getting-started/first-sync): A complete first-time setup, in order.
- [From Existing Skills](https://skillshare.runkids.cc/docs/getting-started/from-existing-skills): You already have skills scattered across ~/.claude/skills/, ~/.cursor/skills/, or other AI CLI directories.
- [Quick Reference](https://skillshare.runkids.cc/docs/getting-started/quick-reference): Command cheat sheet for skillshare.
- [Using skillshare with Claude Code](https://skillshare.runkids.cc/docs/learn/with-claude-code): From install to first sync — 5 minutes.
- [Using skillshare with GitHub Copilot](https://skillshare.runkids.cc/docs/learn/with-copilot): From install to first sync — 5 minutes.
- [Using skillshare with Codex](https://skillshare.runkids.cc/docs/learn/with-codex): From install to first sync — 5 minutes.
- [Using skillshare with Multiple AI Tools](https://skillshare.runkids.cc/docs/learn/with-multiple-tools): One source of truth, synced to every AI CLI you use.
- [Using skillshare in Dev Containers](https://skillshare.runkids.cc/docs/learn/with-devcontainer): Open in VS Code, skills are ready — no local install needed.
- [Try skillshare in the Playground](https://skillshare.runkids.cc/docs/learn/with-playground): A pre-configured Docker sandbox with demo skills, audit rules, and a project — ready to explore in seconds.
- [AI-Assisted Development](https://skillshare.runkids.cc/docs/learn/with-ai-coding-agents): Use AI coding agents to contribute to skillshare with pre-built project skills.

## How-To

- [How-To Guides](https://skillshare.runkids.cc/docs/how-to/): Practical guides for specific tasks and use cases.
- [Daily Workflow](https://skillshare.runkids.cc/docs/how-to/daily-tasks/daily-workflow): The edit → sync → commit/push/pull cycle for everyday skill management.
- [Set up MCP once for your Agents](https://skillshare.runkids.cc/docs/how-to/daily-tasks/sharing-mcp): MCP lets an Agent use tools supplied by another program or service.
- [Manage plugins across tools](https://skillshare.runkids.cc/docs/how-to/daily-tasks/sharing-plugins): A plugin can include skills, MCP connections, hooks, scripts, and other files
- [Share one AGENTS.md across your tools](https://skillshare.runkids.cc/docs/how-to/daily-tasks/sharing-instructions): Each AI tool reads its standing instructions from its own file.
- [Skill Discovery](https://skillshare.runkids.cc/docs/how-to/daily-tasks/skill-discovery): Find, evaluate, and install skills from the community.
- [Backup & Restore](https://skillshare.runkids.cc/docs/how-to/daily-tasks/backup-restore): Protect your skills and recover from mistakes.
- [Project Workflow](https://skillshare.runkids.cc/docs/how-to/daily-tasks/project-workflow): The edit → sync → commit cycle for project-level skill management.
- [Creating Skills](https://skillshare.runkids.cc/docs/how-to/daily-tasks/creating-skills): From idea to published skill.
- [Filtering Skills](https://skillshare.runkids.cc/docs/how-to/daily-tasks/filtering-skills): Skillshare provides three filtering layers that control which skills reach which targets.
- [Organizing Skills with Folders](https://skillshare.runkids.cc/docs/how-to/daily-tasks/organizing-skills): As your skill collection grows, organizing them into folders keeps things manageable — and skillshare handles the rest automatically.
- [Best Practices](https://skillshare.runkids.cc/docs/how-to/daily-tasks/best-practices): Naming conventions, organization, and version control for skills.
- [Project Setup](https://skillshare.runkids.cc/docs/how-to/sharing/project-setup): Set up project-level skills from scratch — skills scoped to a single repository, shared with your team via git.
- [Organization-Wide Skills](https://skillshare.runkids.cc/docs/how-to/sharing/organization-sharing): Share skills across all projects using tracked repositories.
- [Cross-Machine Sync](https://skillshare.runkids.cc/docs/how-to/sharing/cross-machine-sync): Sync your skills across multiple computers using git.
- [Hub Index Guide](https://skillshare.runkids.cc/docs/how-to/sharing/hub-index): Build a centralized skill catalog for your organization — no GitHub API or token required.
- [Migration](https://skillshare.runkids.cc/docs/how-to/advanced/migration): Migrate from other skill management approaches to skillshare.
- [Centralized vs Local-First](https://skillshare.runkids.cc/docs/how-to/advanced/local-first): Skill management tools generally follow one of two architectural approaches: centralized platforms or local-first.
- [Docker: Test, Develop, and Deploy](https://skillshare.runkids.cc/docs/how-to/advanced/docker-sandbox): Use Docker for repeatable testing, frontend development without Go, production deployment, and automated skill validation in CI.
- [Securing Your Skills](https://skillshare.runkids.cc/docs/how-to/advanced/security): AI skills are powerful — they instruct AI assistants to read files, run commands, and interact with your system.
- [Recipes](https://skillshare.runkids.cc/docs/how-to/recipes/): Copy-paste solutions for common skillshare scenarios.
- [Recipe: CI/CD Skill Validation](https://skillshare.runkids.cc/docs/how-to/recipes/ci-cd-skill-validation): Audit and sync skills automatically in your CI pipeline.
- [Recipe: Pre-commit Hook](https://skillshare.runkids.cc/docs/how-to/recipes/pre-commit-hook): Run skillshare audit automatically on every commit using the pre-commit framework.
- [Recipe: Private Enterprise Skills](https://skillshare.runkids.cc/docs/how-to/recipes/private-enterprise-skills): Install skills from private repositories using token authentication.
- [Recipe: Project Mode Workflow](https://skillshare.runkids.cc/docs/how-to/recipes/skill-per-project-workflow): Manage project-scoped skills that travel with your codebase.
- [Recipe: Cross-Machine Sync](https://skillshare.runkids.cc/docs/how-to/recipes/cross-machine-sync-recipe): Keep skills in sync across multiple machines using git push/pull.
- [Recipe: Team Onboarding](https://skillshare.runkids.cc/docs/how-to/recipes/team-onboarding-recipe): Set up a new team member's AI skill environment in under 5 minutes.
- [Centralized Skills Repo](https://skillshare.runkids.cc/docs/how-to/recipes/centralized-skills-repo): Use one project as a shared skills repository; other projects stay clean.
- [Recipe: Many Projects, One Config](https://skillshare.runkids.cc/docs/how-to/recipes/many-projects-one-config): Send skills and MCP servers into several project folders from the global config, with one sync.

## Understand

- [Understand](https://skillshare.runkids.cc/docs/understand/): Understanding these concepts helps you get the most out of skillshare.
- [Source & Targets](https://skillshare.runkids.cc/docs/understand/source-and-targets): The core model behind skillshare: one source, many targets.
- [Sync Modes](https://skillshare.runkids.cc/docs/understand/sync-modes): How skillshare links source to targets.
- [Tracked Repositories](https://skillshare.runkids.cc/docs/understand/tracked-repositories): Git repos installed with --track for team sharing and easy updates.
- [Skill Format](https://skillshare.runkids.cc/docs/understand/skill-format): The structure and metadata of a skillshare skill.
- [Agents](https://skillshare.runkids.cc/docs/understand/agents): Single-file .md resources managed alongside skills — same sync, audit, and lifecycle, different shape.
- [Project Skills](https://skillshare.runkids.cc/docs/understand/project-skills): Run skillshare at the project level — skills scoped to a single repository, shared via git.
- [Declarative Skill Manifest](https://skillshare.runkids.cc/docs/understand/declarative-manifest): Define your skill collection as code — install, share, and reproduce setups from a single manifest file.
- [Audit Engine](https://skillshare.runkids.cc/docs/understand/audit-engine): How skillshare detects security threats in AI skill files — threat model, detection rules, risk scoring, command tiering, and cross-skill analysis.
- [Why Local-First](https://skillshare.runkids.cc/docs/understand/philosophy/why-local-first): skillshare is a single binary with no runtime dependencies.
- [Security-First Design](https://skillshare.runkids.cc/docs/understand/philosophy/security-first): AI skills are executable instructions.
- [Comparing Skill Management Approaches](https://skillshare.runkids.cc/docs/understand/philosophy/comparison): This page compares the two main architectural approaches to AI CLI skill management: imperative (install-per-command) and declarative (config + sync).
- [Skill Design](https://skillshare.runkids.cc/docs/understand/philosophy/skill-design): How to write skills that work reliably — choosing the right complexity level, maximizing determinism, and using progressive disclosure.
- [Skill Design Patterns](https://skillshare.runkids.cc/docs/understand/philosophy/skill-design-patterns): Five structural templates to jump-start your skills.
- [Sync Modes Explained](https://skillshare.runkids.cc/docs/understand/philosophy/sync-modes-explained): A deep dive into the three sync modes — merge, copy, and symlink — when to use each, and the trade-offs.

## Reference

- [Reference](https://skillshare.runkids.cc/docs/reference/): Technical reference documentation for skillshare.
- [Commands](https://skillshare.runkids.cc/docs/reference/commands/): Complete reference for all skillshare commands.
- [init](https://skillshare.runkids.cc/docs/reference/commands/init): First-time setup.
- [install](https://skillshare.runkids.cc/docs/reference/commands/install): Add skills from GitHub repos, git URLs, or local paths.
- [uninstall](https://skillshare.runkids.cc/docs/reference/commands/uninstall): Remove one or more skills or tracked repositories from the source directory.
- [list](https://skillshare.runkids.cc/docs/reference/commands/list): List all installed skills in the source directory.
- [search](https://skillshare.runkids.cc/docs/reference/commands/search): Discover and install skills from GitHub repositories.
- [sync](https://skillshare.runkids.cc/docs/reference/commands/sync): Push skills from source to all targets.
- [mcp](https://skillshare.runkids.cc/docs/reference/commands/mcp): Manage portable MCP connection definitions and synchronize native Agent settings.
- [plugin](https://skillshare.runkids.cc/docs/reference/commands/plugin): Manage complete native plugins across supported tools.
- [status](https://skillshare.runkids.cc/docs/reference/commands/status): Show the current state of skillshare: source, tracked repositories, targets, and versions.
- [new](https://skillshare.runkids.cc/docs/reference/commands/new): Create a new skill with a SKILL.md template.
- [check](https://skillshare.runkids.cc/docs/reference/commands/check): Check for available updates to tracked repositories and installed skills without applying changes.
- [update](https://skillshare.runkids.cc/docs/reference/commands/update): Update one or more skills or tracked repositories to the latest version.
- [upgrade](https://skillshare.runkids.cc/docs/reference/commands/upgrade): Upgrade the skillshare CLI binary and/or the built-in skillshare skill.
- [enable / disable](https://skillshare.runkids.cc/docs/reference/commands/enable): Temporarily enable or disable skills without removing them.
- [target](https://skillshare.runkids.cc/docs/reference/commands/target): Manage sync targets (AI CLI skill directories).
- [diff](https://skillshare.runkids.cc/docs/reference/commands/diff): Show differences between source and targets.
- [collect](https://skillshare.runkids.cc/docs/reference/commands/collect): Collect local skills or agents from targets back to source.
- [extras](https://skillshare.runkids.cc/docs/reference/commands/extras): Manage non-skill resources (rules, commands, prompts, etc.) that are synced alongside skills.
- [backup](https://skillshare.runkids.cc/docs/reference/commands/backup): Create, list, and manage backups of target directories.
- [restore](https://skillshare.runkids.cc/docs/reference/commands/restore): Restore a target from a backup.
- [trash](https://skillshare.runkids.cc/docs/reference/commands/trash): Manage uninstalled skills and agents in the trash directory.
- [push](https://skillshare.runkids.cc/docs/reference/commands/push): Commit and push source to git remote.
- [pull](https://skillshare.runkids.cc/docs/reference/commands/pull): Pull from git remote and sync to all targets.
- [analyze](https://skillshare.runkids.cc/docs/reference/commands/analyze): Analyze context window usage and skill quality for each target's skills.
- [audit](https://skillshare.runkids.cc/docs/reference/commands/audit): Scan installed skills for security threats and malicious patterns.
- [audit rules](https://skillshare.runkids.cc/docs/reference/commands/audit-rules): Browse, enable, disable, and customize audit rules.
- [hub](https://skillshare.runkids.cc/docs/reference/commands/hub): Manage skill hubs — saved hub sources for organization-wide skill discovery.
- [log](https://skillshare.runkids.cc/docs/reference/commands/log): View persistent operations and audit logs for debugging and compliance.
- [doctor](https://skillshare.runkids.cc/docs/reference/commands/doctor): Check environment and diagnose issues with your skillshare setup.
- [tui](https://skillshare.runkids.cc/docs/reference/commands/tui): Toggle interactive TUI mode globally.
- [ui](https://skillshare.runkids.cc/docs/reference/commands/ui): Launch the web dashboard for visual skill management.
- [version](https://skillshare.runkids.cc/docs/reference/commands/version): Show the current skillshare version.
- [Targets](https://skillshare.runkids.cc/docs/reference/targets/): Targets are AI CLI skill directories that skillshare syncs to.
- [Supported Targets](https://skillshare.runkids.cc/docs/reference/targets/supported-targets): Complete list of AI CLIs that skillshare supports out of the box.
- [Adding Custom Targets](https://skillshare.runkids.cc/docs/reference/targets/adding-custom-targets): Add any tool with a skills directory to skillshare.
- [Configuration](https://skillshare.runkids.cc/docs/reference/targets/configuration): Configuration file reference for skillshare.
- [Filtering Reference](https://skillshare.runkids.cc/docs/reference/filtering): Complete specification of the three filtering layers that control which skills reach which targets.
- [Appendix](https://skillshare.runkids.cc/docs/reference/appendix/): Technical reference appendix for skillshare.
- [Environment Variables](https://skillshare.runkids.cc/docs/reference/appendix/environment-variables): All environment variables recognized by skillshare.
- [File Structure](https://skillshare.runkids.cc/docs/reference/appendix/file-structure): Directory layout and file locations for skillshare.
- [URL Formats](https://skillshare.runkids.cc/docs/reference/appendix/url-formats): All source URL patterns recognized by skillshare install.

## Troubleshooting

- [Troubleshooting](https://skillshare.runkids.cc/docs/troubleshooting/): Having issues?
- [Troubleshooting Workflow](https://skillshare.runkids.cc/docs/troubleshooting/troubleshooting-workflow): Systematic approach to diagnosing and fixing issues.
- [Common Errors](https://skillshare.runkids.cc/docs/troubleshooting/common-errors): Error messages and their solutions.
- [Windows](https://skillshare.runkids.cc/docs/troubleshooting/windows): Windows-specific issues and solutions.
- [FAQ](https://skillshare.runkids.cc/docs/troubleshooting/faq): Frequently asked questions about skillshare.

## Optional

- [Full documentation](https://skillshare.runkids.cc/llms-full.txt): Every page above in one Markdown file