| name | skillshare |
| description | Manages and syncs AI CLI skills and agents across 50+ tools from a single source.
Use this skill whenever the user mentions "skillshare", runs skillshare commands,
manages skills or agents (install, update, uninstall, sync, commit, audit, analyze, check, diff, search),
or troubleshoots skill/agent configuration (orphaned symlinks, broken targets, sync
issues). Covers both global (~/.config/skillshare/) and project (.skillshare/)
modes. Also use when: adding new AI tool targets (Claude, Cursor, Windsurf, etc.),
setting target include/exclude filters or copy vs symlink mode, using backup/restore
or trash recovery, piping skillshare output to scripts (--json), setting up CI/CD
audit pipelines, building/sharing skill hubs (hub index, hub add), or working with
agents (single .md files synced to agent-capable targets like Claude, Cursor,
Augment, OpenCode) via positional `agents` filter or `--kind agent`, plus
`.agentignore` and `enable`/`disable` for per-agent toggles.
|
| argument-hint | [command] [target] [--json] [--dry-run] [-p|-g] |
| metadata | {"version":"v0.20.0"} |
Skillshare CLI
Global: ~/.config/skillshare/skills/ → all AI CLIs. Project: .skillshare/skills/ → repo-local.
Auto-detects project mode when .skillshare/config.yaml exists. Force with -p or -g.
Recipes
Getting Started
skillshare init --no-copy --all-targets --git --skill
skillshare init -p --targets "claude,cursor"
skillshare init --copy-from claude --all-targets --git
skillshare init --discover --select "windsurf"
Installing Skills
skillshare install user/repo -s pdf,commit
skillshare install user/repo --all
skillshare install user/repo --into frontend
skillshare install gitlab.com/team/repo
skillshare install user/repo --track
skillshare install user/repo -b develop --all
skillshare install user/repo --track -b develop
skillshare install user/repo -s pdf -p
skillshare install
skillshare sync
Extras (Rules, Commands, Prompts)
skillshare extras init rules --target ~/.claude/rules --target ~/.cursor/rules
skillshare extras init commands --target ~/.claude/commands --mode copy
skillshare extras init rules --target ~/.claude/rules --source ~/shared/rules
skillshare extras init rules --target ~/.cursor/rules --force
skillshare extras init
skillshare extras source
skillshare extras source ~/shared/extras
skillshare extras list
skillshare extras list --json
skillshare extras collect rules
skillshare extras remove rules
skillshare extras init agents --target ~/.claude/agents --flatten
skillshare extras rules --mode copy
skillshare extras agents --flatten
skillshare sync extras
skillshare sync extras --dry-run --force
skillshare sync --all
A target can set an extension: field in config.yaml to transform each source file during sync (e.g. markdown → TOML for Gemini/Codex); implies copy mode. See extras.md for details.
Creating & Discovering Skills
skillshare new my-skill
skillshare new my-skill -P reviewer
skillshare search "react testing"
skillshare collect
Removing Skills
skillshare uninstall my-skill
skillshare uninstall skill-a skill-b
skillshare uninstall -G frontend
skillshare sync
Enable / Disable Skills
skillshare disable draft-*
skillshare enable draft-*
skillshare disable my-skill -p
skillshare disable my-skill --dry-run
skillshare sync
Team / Organization
skillshare install -p && skillshare sync
skillshare install github.com/team/repo --track -p
skillshare commit -m "Update skill"
skillshare push
skillshare pull
Skill Hubs
skillshare hub add https://example.com/hub.json
skillshare hub add https://example.com/hub.json --label my-hub
skillshare hub list
skillshare hub default my-hub
skillshare hub remove my-hub
skillshare hub index --source ~/.config/skillshare/skills/ --full --audit
Controlling Where Skills Go
skillshare target claude --add-include "team-*"
skillshare target claude --add-agent-include "team-*"
skillshare target claude --add-exclude "_legacy*"
skillshare target claude --agent-mode copy
skillshare target codex --mode copy && skillshare sync --force
See targets.md for details.
Updates & Maintenance
skillshare check
skillshare update my-skill && skillshare sync
skillshare update --all && skillshare sync
skillshare update --all --diff
Scripting & CI/CD
skillshare status --json
skillshare check --json
skillshare sync --json
skillshare diff --json
skillshare install user/repo --json
skillshare update --all --json
skillshare uninstall my-skill --json
skillshare collect claude --json
skillshare target list --json
skillshare list --json
skillshare search react --json
skillshare audit --format json
skillshare doctor --json
Recovery & Troubleshooting
skillshare trash restore <name> && skillshare sync
skillshare sync
skillshare doctor && skillshare status
skillshare install user/repo --force
skillshare install user/repo --skip-audit
See TROUBLESHOOTING.md for more.
Quick Lookup
| Commands | Project? | --json? |
|---|
status, diff, list, doctor | ✓ (auto) | ✓ |
sync, collect | ✓ (auto) | ✓ |
install, uninstall, update, check, search, new | ✓ (-p) | ✓ (except new) |
target, audit, analyze, trash, log, hub | ✓ (-p) | ✓ (target list, audit, analyze, log) |
extras init/list/remove/collect/source/mode | ✓ (-p, except source) | ✓ (list, mode) |
enable, disable | ✓ (auto) | ✗ |
commit, push, pull, backup, restore | ✗ | ✗ |
tui, upgrade | ✗ | ✗ |
ui | ✓ (-p) | ✗ |
AI Caller Rules
- Non-interactive — AI cannot answer prompts. Use
--force, --all, -s, --targets, --no-copy, --all-targets, --yes.
- Sync after mutations —
install, uninstall, update, collect, target all need sync.
- Audit —
install auto-scans; CRITICAL blocks. --force to override, --skip-audit to bypass. Detects hardcoded secrets (API keys, tokens, private keys).
- Uninstall safely — moves to trash (7 days).
trash restore <name> to undo. NEVER rm -rf symlinks.
- Output —
--json for structured data (12 commands support it, see Quick Lookup). --no-tui for plain text on TUI commands (list, log, audit, analyze, diff, trash list, backup list, target list). tui off disables TUI globally. --dry-run to preview.
References