AgentSkillsCN

skillshare

从单一可信源同步AI CLI工具中的各项技能(Claude、Cursor、Windsurf等)。 全局模式(~/.config/skillshare/)与项目模式(每个仓库对应的.git/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。 适用场景:跨AI工具管理技能、“skillshare” CLI、技能同步/安装/搜索, 项目技能配置、安全审计、Web仪表盘,或故障排查。

SKILL.md
--- frontmatter
name: skillshare
version: 0.11.7
description: |
  Syncs skills across AI CLI tools (Claude, Cursor, Windsurf, etc.) from a single source of truth.
  Global mode (~/.config/skillshare/) and project mode (.skillshare/ per-repo).
  Commands: status, sync, install, uninstall, update, check, search, new, collect,
  push, pull, diff, list, doctor, audit, init-rules, trash, log, backup, restore, target, ui, upgrade.
  Use when: managing skills across AI tools, "skillshare" CLI, skill sync/install/search,
  project skills setup, security audit, web dashboard, or troubleshooting.
argument-hint: "[command] [target] [--dry-run] [-p|-g]"

Skillshare CLI

Two Modes

code
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

CategoryCommandsProject?
Inspectstatus, diff, list, doctor✓ (auto)
Syncsync, collect✓ (auto)
Remotepush, pull✗ (use git)
Skillsnew, install, uninstall, update, check, search✓ (-p)
Targetstarget add/remove/list✓ (-p)
Securityaudit [name]✓ (-p)
Trashtrash list|restore|delete|empty✓ (-p)
Loglog [--audit] [--tail N]✓ (-p)
Backupbackup, restore
Web UIui (-g global, -p project)✓ (-p)
Upgradeupgrade [--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.

bash
# Key non-interactive patterns
skillshare init --no-copy --all-targets --git --skill   # Global fresh start
skillshare init -p --targets "claude-code,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)
  • 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

TopicFile
Init flags (global + project)init.md
Sync/collect/push/pullsync.md
Install/update/uninstall/newinstall.md
Status/diff/list/search/checkstatus.md
Security auditaudit.md
Trash (soft-delete)trash.md
Operation loglog.md
Target managementtargets.md
Backup/restorebackup.md
TroubleshootingTROUBLESHOOTING.md