skillshare

从单一真实来源同步AI CLI工具（如Claude, Cursor, Windsurf等）的技能。全局模式（~/.config/skillshare/）和项目模式（每个仓库的.skillshare/）。命令：status, sync, install, uninstall, update, check, search, new, collect, push, pull, diff, list, doctor, audit, init-rules, trash, log, backup, restore, target, ui, upgrade。特性：目标级技能过滤（包含/排除），技能级目标字段，支持XDG基本目录，单库安装时模糊子目录解析，.skillignore用于仓库级技能过滤，--exclude标志，许可证显示，多技能和组卸载（--group/-G），声明式技能清单（全局+项目），组织放置的组字段，支持49个以上的目标。使用场景：跨AI工具管理技能，“skillshare”CLI，技能同步/安装/搜索，项目技能设置，目标过滤，安全审计，网页仪表板或故障排查。

Skillshare CLI

Two Modes

Global: ~/.config/skillshare/skills → ~/.claude/skills, ~/.cursor/skills, ...
Project: .skillshare/skills/        → .claude/skills, .cursor/skills (per-repo)

Auto-detection: commands run in project mode when .skillshare/config.yaml exists in cwd. Force with -p (project) or -g (global).

Commands

| Category | Commands | Project? | |----------|----------|:--------:| | Inspect | status, diff, list, doctor | ✓ (auto) | | Sync | sync, collect | ✓ (auto) | | Remote | push, pull | ✗ (use git) | | Skills | new, install, uninstall, update, check, search | ✓ (-p) | | Targets | target add/remove/list | ✓ (-p) | | Security | audit [name] | ✓ (-p) | | Trash | trash list\|restore\|delete\|empty | ✓ (-p) | | Log | log [--audit] [--tail N] | ✓ (-p) | | Backup | backup, restore | ✗ | | Web UI | ui (-g global, -p project) | ✓ (-p) | | Upgrade | upgrade [--cli\|--skill] | — |

Workflow: Most commands require sync afterward to distribute changes.

AI Usage Notes

Non-Interactive Mode

AI cannot respond to CLI prompts. Always pass flags to skip interactive prompts.

# Key non-interactive patterns
skillshare init --no-copy --all-targets --git --skill   # Global fresh start
skillshare init -p --targets "claude,cursor"       # Project init
skillshare install user/repo --all                      # Install all skills
skillshare install user/repo -s pdf,commit              # Select specific

See init.md and install.md for all flags.

Safety

install auto-scans skills; CRITICAL findings block install (--force to override)
install shows license from SKILL.md frontmatter in selection/confirmation prompts
uninstall accepts multiple names and --group/-G for batch removal; auto-detects group directories
uninstall moves to trash (7-day retention) — restore with trash restore <name>
NEVER rm -rf symlinked skills — deletes source. Use skillshare uninstall or target remove

See audit.md and trash.md for details.

References

| Topic | File | |-------|------| | Init flags (global + project) | init.md | | Sync/collect/push/pull | sync.md | | Install/update/uninstall/new | install.md | | Status/diff/list/search/check | status.md | | Security audit | audit.md | | Trash (soft-delete) | trash.md | | Operation log | log.md | | Target management | targets.md | | Backup/restore | backup.md | | Troubleshooting | TROUBLESHOOTING.md |