Skills Management · Detailed guide · verified 2026-08-28

skilldock:Detailed Guide

Install, organize and git-sync AI skills for Claude Code, Cursor and Codex from one desktop app.

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

CapabilityPurpose
Skill library management (install/update/delete)See the agent-executable guide
Multi-tool skill sync (one click)See the agent-executable guide
MCP server managementSee the agent-executable guide
Plugin managementSee the agent-executable guide
Git-aware updatesSee the agent-executable guide
Conflict entry identificationSee 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

PathCommandMeasured
Main path (measured)curl -sL -o SkillDock_x64-setup.exe https://gh-proxy.com/https://github.com/wang...✅ measured in this marketplace
Mirror/proxySee quick guide and semi_auto_note; for China installs follow the skilldock guidemeasured
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.

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