skilldock Detailed Guide
Version 1.0.15~1.0.15 | category plugin-mgmt | security (reviewed) | sources: official project docs (English README/docs) + measured in this marketplace (2026-08-28 structure confirmation)
Companion: site docs (manifest + guide + evidence) | quick version: site docs
1. When to use it
SkillDock (by wanghuan9, MIT, 492 stars) is a desktop skill manager for AI coding tools: manages skills, MCP servers and plugins of Claude Code, Cursor, Codex, Windsurf, Gemini CLI, GitHub Copilot etc. in one interface. Features: scans real per-tool directories (distinguishes managed/unmanaged/conflicting), Git-aware updates (tracks upstream + local modifications + push preview), one-click multi-tool sync.
In one sentence: the "package manager + Git client" of the skill world — install, update, sync and conflicts at a glance.
What this tool solves: skill files are scattered across multiple directories for Claude Code / Cursor / Codex, and copying them by hand is easy to mess up. SkillDock is a desktop app that installs, organizes and git-syncs skills for these tools — it scans skill directories, installs skills from Git repos/skills.sh/ClawHub, syncs to multiple tools in one click, and tracks upstream updates and local changes.
When to use it:
- You maintain skills across several Agents and want one management entry;
- You want to install skills from Git repos and keep them updatable;
- You want to preview upstream update diffs before applying.
When not to use it: a pure Linux/headless environment — this entry only has Windows/macOS assets, no Linux build (not run in this environment).
Notes: desktop GUI entry (Windows 10+ / macOS); this doc is based on release metadata + official README audit, commands and expected results are honestly labeled by source.
2. Capability list
| Capability | Purpose |
|---|---|
| Skill library management (install/update/delete) | See the agent-executable guide |
| Multi-tool skill sync (one click) | See the agent-executable guide |
| MCP server management | See the agent-executable guide |
| Plugin management | See the agent-executable guide |
| Git-aware updates | See the agent-executable guide |
| Conflict entry identification | See the agent-executable guide |
3. Quick install
note: Windows asset (structure confirmed in this environment); mainland GitHub direct is slow — must use the gh-proxy prefix
# Source: Trove detailed guide · verified 2026-08-28
curl -sL -o SkillDock_x64-setup.exe https://gh-proxy.com/https://github.com/wanghuan9/skilldock/releases/download/v1.0.15/SkillDock_1.0.15_x64-setup.exe
./SkillDock_x64-setup.exe
Expected output: install wizard (default: next to finish)
Step 1: Confirm the app launches and scans skills
Why: the app launches into the main UI and auto-scans the local tool skill directories, which means the install and read path both work.
# Source: Trove detailed guide · verified 2026-08-28
# GUI: open SkillDock, confirm the main UI and the scanned skill list
Expected output: app main UI + list of local tool skill directories
Stuck? How to recover:
- app won't open → confirm the OS version (Windows 10+ / macOS) and asset match (x64 vs aarch64);
- no skills scanned → confirm the target tool's skill directory exists (SkillDock reads each tool's standard skill directory).
Step 2: Confirm skill install and sync
Why: installing a skill from a Git repo makes it appear in the managed list, and after Sync to the target tool the corresponding files appear in that tool's skill directory — the skill management path is confirmed.
# Source: Trove detailed guide · verified 2026-08-28
# GUI: Skills → Install → paste the Git URL → tick the target tool → Sync
Expected output: skill added + distributed to the selected tool directories
Stuck? How to recover:
- can't install → confirm the repo URL and network; whether the skill format matches the app's requirements (documented in the official README/docs);
- sync overwrites hand-edited skills → back up before syncing (sync writes each tool's skill directory).
Install variants
| Path | Command | Measured |
|---|---|---|
| Main path (measured) | curl -sL -o SkillDock_x64-setup.exe https://gh-proxy.com/https://github.com/wang... | ✅ measured in this marketplace |
| Mirror/proxy | See quick guide and semi_auto_note; for China installs follow the skilldock guide | measured |
Semi-auto note: official assets v1.0.15 (2026-08-19, 6 assets) are Windows exe + macOS dmg/app only — no Linux binary (not measured running in this WSL environment); confirmed via latest.json metadata + README structural audit; desktop GUI form; management surface = each agent's skill directories (Claude Code/Cursor/Codex/Windsurf/Gemini CLI/Copilot) + MCP config + plugins; Git-aware updates (tracks upstream + local modifications); install = desktop app setup wizard
- Platform: only Windows (setup.exe) and macOS (dmg) assets, no Linux build; pick x64 / aarch64 by platform.
- Write surface: app config
~/.config/SkillDock/~/.skilldock; writes to each tool's skill directory when syncing (shared write surface, back up before syncing). - Desktop app form: no CLI, no background service; no conflict matrix pairs for co-install (GUI runs independently).
4. Why this happens (mechanism & shared surface)
How it works: the installer (Windows setup.exe / macOS dmg) installs a desktop app. On first launch it automatically scans the skill directories of Claude Code/Cursor/Codex/Windsurf etc., groups skills into managed/unmanaged/conflicted; installs skills from a Git URL/skills.sh/ClawHub; syncs to the selected tools in one click; previews diffs before Git updates.
Key concepts:
- Skill directory scanning: auto-discovers each tool's skill locations;
- Multi-tool sync: one copy of a skill distributed to multiple Agents;
- Git updates: tracks upstream + local changes, preview then apply.
Where it writes: ~/.config/SkillDock / ~/.skilldock (app config); writes to each tool's skill directory when syncing.
Official assets v1.0.15 (2026-08-19, 6 assets) are Windows exe + macOS dmg/app only — no Linux binary (not measured running in this WSL environment); confirmed via latest.json metadata + README structural audit; desktop GUI form; management surface = each agent's skill directories (Claude Code/Cursor/Codex/Windsurf/Gemini CLI/Copilot) + MCP config + plugins; Git-aware updates (tracks upstream + local modifications); install = desktop app setup wizard
5. Common operations
Step 1: Install the app (Windows / macOS, pick one)
Why: Windows uses the setup.exe install wizard; macOS drags the dmg into Applications. Mainland GitHub direct is slow, downloads go through the gh-proxy prefix. Note: this entry only has Windows/macOS assets, no Linux build.
# Source: Trove detailed guide · verified 2026-08-28
curl -sL -o SkillDock_x64-setup.exe https://gh-proxy.com/https://github.com/wanghuan9/skilldock/releases/download/v1.0.15/SkillDock_1.0.15_x64-setup.exe
./SkillDock_x64-setup.exe
Expected output: install wizard (default: next to finish)
macOS branch:
# Source: Trove detailed guide · verified 2026-08-28
curl -sL -o SkillDock.dmg https://gh-proxy.com/https://github.com/wanghuan9/skilldock/releases/download/v1.0.15/SkillDock_1.0.15_aarch64.dmg
open SkillDock.dmg
Expected output: drag into Applications
After install, confirm:
- the app launches and enters the main UI;
- it auto-scans the local skill directories of each tool.
Stuck? How to recover:
- download slow → confirm the gh-proxy prefix; retry on another network;
- app won't open → confirm the OS version (Windows 10+ / macOS) and asset match (x64 vs aarch64).
Step 2: Install a skill from a Git repo (GUI)
Why: Skills → Install → paste the Git URL; the skill is added and can optionally sync to the target tool.
# Source: Trove detailed guide · verified 2026-08-28
# GUI: Skills → Install → paste the Git URL
Expected output: skill added, optionally synced to the target tool
After install, confirm:
- the skill shows in the managed list.
Stuck? How to recover:
- can't install → confirm the repo URL and network; whether the skill format matches the app's requirements (documented in the official README/docs).
Step 3: One-click multi-tool sync + Git update (GUI)
Why: in the skill detail, tick the target tools and Sync to distribute; before a Git update, preview the diff (upstream update vs local changes), then Update/Push after confirming.
# Source: Trove detailed guide · verified 2026-08-28
# GUI: skill detail → tick Claude Code/Codex/Cursor → Sync
Expected output: skill distributed to the selected tools (no hand-copying files)
# Source: Trove detailed guide · verified 2026-08-28
# GUI: skill list → review upstream updates/local changes → preview → Update/Push
Expected output: diff preview before updating, apply after confirming
Stuck? How to recover:
- sync overwrites hand-edited skills → multi-tool sync writes each tool's skill directory, back up before syncing;
- behavior changes after Git update → read the diff preview carefully before applying.
Startup and entry
Desktop app, launch from Start menu/Applications.
Common operations
Operation 1: Scan each tool's skill directories
# Source: Trove detailed guide · verified 2026-08-28
# GUI: open the app → auto-scan Claude Code/Cursor/Codex/Windsurf etc. skill directories
Expected output: grouped list of managed/unmanaged/conflicted entries
Operation 2: Install a skill (Git repo / skills.sh / ClawHub)
# Source: Trove detailed guide · verified 2026-08-28
# GUI: Skills → Install → paste the Git URL
Expected output: skill added, optionally synced to the target tool
Operation 3: One-click multi-tool sync
# Source: Trove detailed guide · verified 2026-08-28
# GUI: skill detail → tick Claude Code/Codex/Cursor → Sync
Expected output: skill distributed to the selected tools (no hand-copying files)
Operation 4: Git update (track upstream + local changes)
# Source: Trove detailed guide · verified 2026-08-28
# GUI: skill list → review upstream updates/local changes → preview → Update/Push
Expected output: diff preview before updating, apply after confirming
Data and directories
- App config:
~/.config/SkillDock/~/.skilldock; - Writes to each tool's skill directory when syncing (Claude Code/Cursor/Codex etc.).
6. Conflict pairs (summary)
Same source as the tool-page matrix — 19 pairs total (0 measured compatible / 12 inferred possibly compatible / 7 inferred possibly conflicting); full pairs, states and evidence: Conflict pairs (co-install matrix).
7. Quick troubleshooting
- No standalone handbook yet; for install/uninstall issues first see the agent-executable guide notes
8. Uninstall and residue check
# Source: Trove detailed guide · verified 2026-08-28
rm -rf ~/.config/SkillDock ~/.skilldock 2>/dev/null || true
note: platform uninstaller + config cleanup; managed shared config is not restored
# Source: Trove detailed guide · verified 2026-08-28
# Windows: Settings → Apps → uninstall SkillDock; macOS: drag to Trash
rm -rf ~/.config/SkillDock ~/.skilldock 2>/dev/null || true
ls ~/.config/SkillDock ~/.skilldock 2>/dev/null | grep -q . && echo '残留: SkillDock 配置仍在' || echo 'skilldock removed: OK'
Expected output: skilldock removed: OK
9. FAQ
- Runtime preflight (Windows 10+ or macOS; no Linux assets in this marketplace)
- Official release assets (structure confirmed here); direct GitHub from China is slow and must use gh-proxy
- GUI operations; each item = goal + expected effect; official docs = project README/docs
- Platform uninstaller + config cleanup; managed shared config is not restored
- Shared management surface: it manages each tool's skill directories + MCP config + plugin registration — same-surface risk with superpowers/agent-skills (skill directories), omc/claude-mem (plugin/MCP registration), ruflo/code-review-graph (MCP), cc-switch (skill/MCP management) (judged possible-conflict in this marketplace)
- Q: Is there a Linux version? A: No. This entry only has Windows/macOS assets.
- Q: Will sync overwrite my hand-edited skills? A: Git updates have a diff preview (upstream vs local changes); but multi-tool sync writes each tool's skill directory — back up before syncing.
- Q: Use it with skillspector? A: Different forms (desktop management vs security scanning), no shared write-surface conflict; security advice: after installing skills, run skillspector to scan before enabling.
- Q: Where to report problems? A: install/uninstall issues on this marketplace go through the entry feedback channel; project issues go to the author's repository.
- Version:
[1.0.15, 1.0.15]locked (collection structure confirmed version). - Environment: Windows 10+ / macOS (no Linux asset); x64 / aarch64 assets by platform.
- Network: GitHub direct is slow — must use the gh-proxy prefix (verified path).
- Write surface: app config
~/.config/SkillDock/~/.skilldock; writes to each tool's skill directory when syncing (shared write surface, back up before syncing). - Co-install: no conflict matrix pairs (desktop app form).
10. Sources
- Verified:
local repro log(2026-08-28, release asset structure confirmed: Windows/macOS download URLs and versions). - Not tested: GUI run and skill sync (no Windows/macOS environment) — expected results come from the official README/docs, honestly labeled.
External tutorials (unverified)
Third-party tutorials are not individually verified; check against this page and official docs.
- 官方 README(codeload tarball v1.0.15 中文版,2026-08-31 结构实测):SkillDock 完整用法 [官方文档 · SkillDock 官方 · 2026-08-31(tag v1.0.15)]
官方用法全解——Skill/MCP/Plugin 三类托管、安装方式(Skill 安装 / MCP 安装 / Plugin 安装)、设置、支持的工具清单、工作机制(Skill 托管与工作流、兼容 Agent Skills CLI)、企业 Skill 管理与内部平台集成、下载渠道
Merged sources
This page merges multiple source articles — deduplicated by content hash, measured, and rewritten by AI. Sources are not scattered; they all live on this single page.
No merged sources yet: this page distills local verification and community rewrites; provenance details live on the linked solution page.
← Back to skilldock solution page | Skills Management domain