Development
Plugin
skillshare
📚 Sync skills across all AI CLI tools with one command and simplify team sharing. Supporting Codex, Claude Code, OpenClaw & more
Plugin Signal70/100Solid
maintained100
capable14
documented100
adopted72
Install
$ npx -y skills add runkids/skillshare --agent claude-code
Run the curl in your terminal, the rest in Claude Code.
Stats
2,534
Stars
154
Forks
Active
Maintenance
Go
Language
MIT
License
1h ago
Last commit
6mo ago
Created
Repo: runkids/skillshare
What's inside
README
1[!NOTE] Latest: v0.20.0 — choose what
commit/push/pullversion with git_root scope (skills, agents, extras, or all together in one repo); extras extension transforms convert Markdown to native formats (Gemini TOML commands, Codex TOML agents) during sync. All releases →
Why skillshare
Every AI CLI has its own skills directory. You edit in one, forget to copy to another, and lose track of what's where.
skillshare fixes this:
- One source, every agent — sync to Claude, Cursor, Codex & 60+ more with
skillshare sync - Agent management — sync custom agents alongside skills to agent-capable targets
- More than skills — manage rules, commands, prompts & any file-based resource with extras
- Install from anywhere — GitHub, GitLab, Bitbucket, Azure DevOps, or any self-hosted Git
- Built-in security — audit skills for prompt injection and data exfiltration before use
- Team-ready — project skills in
.skillshare/, org-wide skills via tracked repos - Local & lightweight — single binary, no registry, no telemetry, fully offline-capable
- Fine-grained filtering — control which skills reach which targets with
.skillignore, SKILL.mdtargets, and per-target include/exclude
Coming from another tool? Migration Guide · Comparison
How It Works
- macOS / Linux:
~/.config/skillshare/ - Windows:
%AppData%\skillshare\
┌─────────────────────────────────────────────────────────────┐
│ Source Directory │
│ ~/.config/skillshare/skills/ ← skills (SKILL.md) │
│ ~/.config/skillshare/agents/ ← agents │
│ ~/.config/skillshare/extras/ ← rules, commands, etc. │
└─────────────────────────────────────────────────────────────┘
│ sync
┌───────────────┼───────────────┐
▼ ▼ ▼
┌───────────┐ ┌───────────┐ ┌───────────┐
│ Claude │ │ OpenCode │ │ OpenClaw │ ...
└───────────┘ └───────────┘ └───────────┘
| Platform | Skills Source | Agents Source | Extras Source | Link Type |
|---|---|---|---|---|
| macOS/Linux | ~/.config/skillshare/skills/ | ~/.config/skillshare/agents/ | ~/.config/skillshare/extras/ | Symlinks |
| Windows | %AppData%\skillshare\skills\ | %AppData%\skillshare\agents\ | %AppData%\skillshare\extras\ | NTFS Junctions (no admin required) |
| Imperative (install-per-command) | Declarative (skillshare) | |
|---|---|---|
| Source of truth | Skills copied independently | Single source → symlinks (or copies) |
| New machine setup | Re-run every install manually | git clone config + sync |
| Security audit | None | Built-in audit + auto-scan on install/update |
| Web dashboard | None | skillshare ui |
| Runtime dependency | Node.js + npm | None (single Go binary) |
CLI and UI Preview
| Skill Detail | Security Audit |
|---|---|
| UI Dashboard | UI Skills |
|---|---|
Installation
macOS / Linux
curl -fsSL https://raw.githubusercontent.com/runkids/skillshare/main/install.sh | sh
Windows PowerShell
irm https://raw.githubusercontent.com/runkids/skillshare/main/install.ps1 | iex
Homebrew
brew install skillshare
Tip: Run
skillshare upgradeto update to the latest version. It auto-detects your install method and handles the rest.
GitHub Actions
- uses: runkids/setup-skillshare@v1
with:
source: ./skills
- run: skillshare sync
See setup-skillshare for all options (audit, project mode, version pinning).
Shorthand (Optional)
Add an alias to your shell config (~/.zshrc or ~/.bashrc):
alias ss='skillshare'
Quick Start
skillshare init # Create config, source, and detected targets
skillshare sync # Sync skills to all targets
Highlights
Install & update skills —from GitHub, GitLab, or any Git host
skillshare install github.com/reponame/skills
skillshare update --all
skillshare target claude --mode copy # if symlinks don't work
Symlink issues? — switch to copy mode per target
skillshare target <name> --mode copy
skillshare sync
Security audit —scan before skills reach your agent
skillshare audit
Project skills —per-repo, committed with your code
skillshare init -p && skillshare sync
Agents —sync custom agents to agent-capable targets
skillshare sync agents # sync agents only
skillshare sync --all # sync skills + agents + extras together
Extras —manage rules, commands, prompts & more
skillshare extras init rules # create a "rules" extra
skillshare sync --all # sync skills + extras together
skillshare extras collect rules # collect local files back to source
Shell completion —tab-complete commands, flags, and subcommands
skillshare completion bash --install # also: zsh, fish, powershell, nushell
Local checkpoints — commit source changes without pushing
skillshare commit -m "Update review skill"
skillshare commit --dry-run
Web dashboard — visual control panel
skillshare ui
Contributing
Contributions welcome! Open an issue first, then submit a draft PR with tests. See CONTRIBUTING.md for setup details.
git clone https://github.com/runkids/skillshare.git && cd skillshare
make check # format + lint + test
[!TIP] Not sure where to start? Browse open issues or try the Playground for a zero-setup dev environment.
Contributors
Thanks to everyone who helped shape skillshare.
If you find skillshare useful, consider giving it a ⭐
Star History
License
MIT
File tree
1190runkids/skillshareView on GitHub
.air.toml
.codegraph/
.gitignore
.devcontainer/
.env.example
bin/
credential-helper
dev-servers
docs
help
skillshare
ss
ssback
ssenv
sshelp
ssls
ssnew
ssrm
ssuse
test-brew-upgrade
ui
dev-servers.sh
devcontainer.json
docker-compose.yml
ensure-mdproof.sh
ensure-skillshare-linux-binary.sh
install-ssenv-shortcuts.sh
setup.sh
ssenv-shortcuts.sh
start-dev.sh
.dockerignore
.github/
assets/
audit-tui.png
demo.gif
diff-demo.png
doctor-demo.png
install-demo.png
install-with-audio-demo.png
list-demo.png
logo.png
search-demo.png
skill-detail-tui.png
status-demo.png
sync-collision-demo.png
sync-demo.png
team-reack-demo.png
ui/
web-audit-demo.png
web-dashboard-demo.png
web-install-demo.png
web-search-skills-demo.png
web-skill-detail-demo.png
web-skills-demo.png
web-sync-demo.png
uninstall-demo.png
update-skilk-demo.png
update-tracked-demo.png
upgrade-demo.png
windows-init.png
FUNDING.yml
PULL_REQUEST_TEMPLATE.md
RELEASE_TEMPLATE.md
workflows/
docker-publish.yml
release.yaml
test.yaml
website-pages.yml
.gitignore
.goreleaser.yaml
.mdproof/
lessons-learned.md
.pre-commit-hooks.yaml
.skillignore
.skillshare/
.gitignore
config.yaml
skills/
.metadata.json
skillshare-changelog/
SKILL.md
skillshare-cli-e2e-test/
SKILL.md
skillshare-codebase-audit/
SKILL.md
skillshare-devcontainer/
SKILL.md
skillshare-implement-feature/
SKILL.md
skillshare-release/
SKILL.md
skillshare-ui-website-style/
references/
STYLE_GUIDE.md
SKILL.md
skillshare-update-docs/
SKILL.md
.vscode/
extensions.json
ai_docs/
tests/
agents_commands_runbook.md
agents_include_exclude_filter_runbook.md
atomgit_install_runbook.md
audit_output_antigravity_runbook.md
auto_create_target_dir_runbook.md
azure_devops_url_parse_runbook.md
check_treehash_precision_runbook.md
collect_multiple_targets_runbook.md
collect_nested_git_repo_runbook.md
collect_overwrite_semantics_runbook.md
collect_skills_agents_runbook.md
discovery_skip_target_dotdirs_runbook.md
extras_commands_runbook.md
extras_flatten_runbook.md
extras_refactor_json_runbook.md
extras_source_config_runbook.md
first_use_cli_e2e_runbook.md
gitignore_batch_perf_runbook.md
gitlab_hosts_config_runbook.md
gitlab_subgroup_url_parse_runbook.md
global_sources_map_runbook.md
init_skip_skill_prompt_runbook.md
install_mixed_repo_agents_runbook.md
issue124_orchestrator_install_runbook.md
issue46_install_update_optimization_runbook.md
json_output_purity_runbook.md
local_install_source_preservation_runbook.md
mdproof.json
precommit_audit_hook_runbook.md
registry_source_dir_migration_runbook.md
registry_yaml_split_runbook.md
relative_symlinks_runbook.md
skillignore_source_discovery_runbook.md
symlinked_dir_sync_runbook.md
sync_extras_runbook.md
target_command_options_skills_agents_runbook.md
target_local_agents_visibility_runbook.md
target_naming_runbook.md
ui_base_path_runbook.md
uninstall_all_glob_runbook.md
uninstall_sync_orphan_runbook.md
universal_target_path_runbook.md
update_batch_subdir_path_runbook.md
update_prune_check_stale_runbook.md
upgrade_sudo_runbook.md
CHANGELOG.md
cmd/
skillshare/
analyze_project.go
analyze_tui_item.go
analyze_tui_test.go
analyze_tui.go
analyze.go
audit_policy.go
audit_project.go
audit_render.go
audit_rules_tui.go
audit_rules.go
audit_tui.go
audit.go
backup_agents.go
backup_test.go
backup.go
check_project.go
check_test.go
check.go
checklist_tui_test.go
checklist_tui.go
collect_agents.go
collect_project.go
collect_shared.go
collect.go
commit.go
completion_bash.go
completion_fish.go
completion_nushell.go
completion_powershell.go
completion_zsh.go
completion.go
diff_agents.go
diff_extras.go
diff_file_test.go
diff_file.go
diff_project.go
diff_tui_test.go
diff_tui.go
diff.go
doctor_agents.go
doctor_json_test.go
doctor_json.go
doctor_shared_paths_test.go
doctor_shared_paths.go
doctor.go
enable.go
ensure_project_config_test.go
extension_resolve_test.go
extension_resolve.go
extras_add_target.go
extras_collect.go
extras_init_tui.go
extras_init.go
extras_list_tui_item.go
extras_list_tui.go
extras_list.go
extras_mode.go
extras_remove_target.go
extras_remove.go
extras_source.go
extras_target_paths.go
extras.go
gitroot.go
helpers.go
hub_manage.go
hub.go
init_project.go
init_test.go
init.go
install_audit_render.go
install_context_test.go
install_context.go
install_handlers.go
install_project.go
install_prompt_tui.go
install_prompt.go
install_subdir_license_test.go
install_test.go
install_warning_output_test.go
install.go
json_output_test.go
json_output.go
kind_filter_test.go
kind_filter.go
list_project.go
list_test.go
list_tui_content_test.go
list_tui_content.go
list_tui_filter_test.go
list_tui_filter.go
list_tui_item_test.go
list_tui_item.go
list_tui_test.go
list_tui.go
list.go
log_format_test.go
log_format.go
log_max_entries_test.go
log_project.go
log_render.go
log_stats_test.go
log_stats.go
log_tui_item.go
log_tui_test.go
log_tui.go
log.go
main.go
mode_hint.go
mode.go
new_templates_test.go
new_templates.go
new_tui.go
new.go
project_paths.go
project_runtime.go
project_skills.go
pull.go
push.go
restore_tui.go
search_batch_test.go
search_batch.go
search_hub_test.go
search_test.go
search_tui_test.go
search_tui.go
search.go
status_agents.go
status_project.go
status.go
sync_agents.go
sync_budget_test.go
sync_budget.go
sync_extras.go
sync_overlap_hint.go
sync_parallel_test.go
sync_parallel.go
sync_project.go
sync.go
target_agents_test.go
target_agents.go
target_helpers_test.go
target_helpers.go
target_list_tui_item.go
target_list_tui.go
target_project.go
target.go
tracked_metadata.go
trash_tui_test.go
trash_tui.go
trash.go
tui_helpers.go
tui_toggle.go
ui_background_test.go
ui_process_other.go
ui_process_unix.go
ui_process_windows.go
ui.go
uninstall_agents.go
uninstall_project.go
uninstall_test.go
uninstall.go
update_agents.go
update_audit_render.go
update_batch.go
update_handlers.go
update_project.go
update_resolve.go
update_test.go
update.go
upgrade_test.go
upgrade_unix.go
upgrade_windows.go
upgrade.go
CONTRIBUTING.md
docker/
docker-compose.sandbox.yml
ci/
Dockerfile
production/
Dockerfile
entrypoint.sh
sandbox/
Dockerfile
entrypoint.sh
extensions/
codex-agents/
convert.js
extension.yaml
md-toml.js
gemini-commands/
convert.js
extension.yaml
md-toml.js
README.md
go.mod
go.sum
install.ps1
install.sh
internal/
audit/
analyzability_test.go
analyzer_crossskill.go
analyzer_dataflow.go
analyzer_integrity.go
analyzer_metadata_test.go
analyzer_metadata.go
analyzer_registry_test.go
analyzer_registry.go
analyzer_static.go
analyzer_structure.go
analyzer_tier.go
analyzers.go
audit_result_helpers_test.go
audit_rules_test.go
audit_scan_content_test.go
audit_scan_skill_test.go
audit.go
credentials_test.go
credentials.go
crossskill_test.go
crossskill.go
dataflow_test.go
dataflow.go
dedupe_test.go
dedupe.go
export_test.go
markdown_test.go
markdown.go
parallel_test.go
parallel.go
patterns.go
policy_test.go
policy.go
prefilter_test.go
prefilter.go
risk_test.go
rules_list_test.go
rules_list.go
rules_mutate_test.go
rules_mutate.go
rules.yaml
sarif_test.go
sarif.go
scan_benchmark_test.go
testdata/
clean-skill.md
malicious-destructive.md
malicious-exfiltration.md
malicious-injection.md
malicious-obfuscation.md
malicious-unicode.md
... 908 moreFAQ
skillshare is a Claude Code plugin with 1 hand-picked skill for development work, indexed on Flowy. Install it with the command on its page. It includes skillshare. Its skills do not fire on their own yet. Request auto-invocation to have Flowy route them as you prompt. Free and open source.
- What is skillshare?
- 📚 Sync skills across all AI CLI tools with one command and simplify team sharing. Supporting Codex, Claude Code, OpenClaw & more
- How do I install skillshare?
- Run these in Claude Code: npx -y skills add runkids/skillshare --agent claude-code. Then prompt normally.
- Does skillshare auto-invoke its skills?
- Not yet. It is indexed on Flowy as a plain plugin. Request auto-invocation on its page and Flowy will route its skills for you as you prompt.
- Is skillshare free?
- Yes. Flowy is free and open source, with nothing gated. You can read every skill in full before you install.