Skip to content
Back to search

skills-manager

SkillWorks with Claude CodeGitHub

A lightweight desktop app to manage, sync, and organize AI agent skills across 50+ coding tools — Claude Code, Codex, Cursor, Copilot, Gemini CLI, and more.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 11 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/xingkongliang/skills-manager with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/xingkongliang/skills-manager'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/xingkongliang-skills-manager/badge.svg)](/listings/xingkongliang-skills-manager)

HTML

<a href="/listings/xingkongliang-skills-manager"><img src="/api/listings/xingkongliang-skills-manager/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

macOS

Install with [Homebrew](https://brew.sh):

brew install --cask skills-manager

You can also download the `.dmg` for your Mac from the [latest release](https://github.com/xingkongliang/skills-manager/releases/latest).

Windows and Linux

Download the installer for your platform from the [latest release](https://github.com/xingkongliang/skills-manager/releases/latest): `.exe` or `.msi` for Windows, and `.AppImage`, `.deb`, or `.rpm` for Linux (x64 and arm64).

Every installer ships the CLI inside the app — see [Where the binary lives](#where-the-binary-lives).

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 293 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. <p align="center">
  2. <img src="assets/icon.png" width="80" />
  3. </p>
  4. <h1 align="center">Skills Manager</h1>
  5. <p align="center">
  6. One app to manage AI agent skills across all your coding tools.
  7. </p>
  8. <p align="center">
  9. <strong><a href="https://skillsmanager.dev">skillsmanager.dev</a></strong>
  10. </p>
  11. <p align="center">
  12. 🎬 <a href="https://www.youtube.com/watch?v=DJ9RIX8nbow">1.5-min intro (YouTube)</a>
  13. &nbsp;·&nbsp;
  14. <a href="https://www.youtube.com/watch?v=SNVD5ZN6QPE">Full walkthrough (9 min)</a>
  15. &nbsp;·&nbsp;
  16. <a href="https://www.bilibili.com/video/BV1cdpc6PExG/">视频介绍 (Bilibili)</a>
  17. </p>
  18. <p align="center">
  19. <a href="./README.zh-CN.md">中文说明</a>
  20. &nbsp;·&nbsp;
  21. <a href="https://x.com/JayTL00">@JayTL00 on X</a>
  22. &nbsp;·&nbsp;
  23. <a href="https://buymeacoffee.com/jaytl">Buy me a coffee</a>
  24. </p>
  25. <p align="center">
  26. <a href="https://trendshift.io/repositories/23290?utm_source=repository-badge&amp;utm_medium=badge&amp;utm_campaign=badge-repository-23290" target="_blank" rel="noopener noreferrer"><img src="https://trendshift.io/api/badge/repositories/23290" alt="xingkongliang%2Fskills-manager | Trendshift" width="250" height="55"/></a>
  27. </p>
  28. <p align="center">
  29. <a href="https://skills.sh/xingkongliang/skills-manager"><img src="https://skills.sh/b/xingkongliang/skills-manager" alt="manage-skills on skills.sh" /></a>
  30. </p>
  31. <p align="center">
  32. <img src="assets/demo/library.png" width="800" alt="Skills Manager Library" />
  33. </p>
  34. <p align="center"><strong>Install Skills — Marketplace</strong></p>
  35. <p align="center"><img src="assets/demo/install-skills.png" width="800" alt="Install Skills Marketplace" /></p>
  36. <p align="center"><strong>Global Workspace</strong></p>
  37. <p align="center"><img src="assets/demo/global-workspace.png" width="800" alt="Global Workspace" /></p>
  38. <p align="center"><strong>Agent Workspace</strong></p>
  39. <p align="center"><img src="assets/demo/agent-workspace.png" width="800" alt="Agent Workspace" /></p>
  40. <p align="center"><strong>Project Workspace</strong></p>
  41. <p align="center"><img src="assets/demo/project-workspace.png" width="800" alt="Project Workspace" /></p>
  42. <p align="center"><strong>Backup & Multi-Device Sync</strong></p>
  43. <p align="center"><img src="assets/demo/backup.png" width="800" alt="Backup and multi-device sync" /></p>
  44. <p align="center"><strong>Settings</strong></p>
  45. <p align="center"><img src="assets/demo/settings.png" width="800" alt="Settings" /></p>
  46. ## Features
  47. <p align="center">
  48. <img src="assets/diagram-concept-map.png" width="640" alt="Concept map: Library, Preset, Global Workspace, Project Workspace, Agent" />
  49. </p>
  50. - **Unified skill library** — Install skills from Git repos, local folders, `.zip` / `.skill` archives, or the [skills.sh](https://skills.sh) marketplace. Everything goes into one central repo, which defaults to `~/.skills-manager` and can be customized in **Settings**.
  51. - **Marketplace** — Browse popular skills from the marketplace and find them with keyword search.
  52. - **Your agents can manage skills** — Claude Code, Codex, Cursor and the rest can install a skill, deploy it to another agent, or report what is where, by driving Skills Manager instead of writing into an agent's folder behind its back — so sources, presets, update tracking and per-agent state stay intact. The Dashboard sets this up in one click; see [Let your agents manage skills](#let-your-agents-manage-skills).
  53. - **Presets** — Group skills into named presets. In any workspace, click a preset pill to instantly activate or deactivate all its skills for the current agent scope. Applying a preset is a one-time copy, not a live sync. The sidebar lists all presets for quick access.
  54. - **Global Workspace** — Each agent gets its own page listing every skill in its global folder — including ones installed outside Skills Manager — so the view always reflects what the agent actually sees. Add or remove skills per agent, or use the All Agents overview to manage every installed agent at once.
  55. - **Project Workspaces** — View and manage project-local skill folders for supported agents, compare them with your central library, and sync changes in either direction. Supports nested skill directories and per-agent assignment when exporting.
  56. - **Linked Workspaces** — Point to any directory as a skills root — useful for skills that live outside the default agent paths. Managed as a standalone workspace without participating in global preset sync.
  57. - **Multi-tool sync** — Sync skills to any supported tool via symlink or copy with a single click. Every skill card shows an agent icon badge per enabled agent — click a badge to install or remove that skill for that agent right from the card, with the badge reflecting live sync state.
  58. - **Add from Library sheet** — In any workspace, click **+ Add Skills** to open a unified picker: search your central library, toggle target agents with always-visible chips (with select-all/clear), and batch-add multiple skills in one click.
  59. - **Batch operations** — Multi-select skills for bulk enable/disable, export, or delete. Project Workspaces also support bulk enable/disable for project-local skills.
  60. - **Skill tagging and filters** — Tag skills, use tags to group similar skills, and filter by source or tag — including an **Untagged** pill to quickly find skills missing labels.
  61. - **Update tracking** — Check for upstream updates on Git-based skills; re-import local ones.
  62. - **Skill preview and source inspection** — Read `SKILL.md` / `README.md`, inspect source metadata, and compare local content with the upstream version inside the app.
  63. - **Custom tools** — Add your own agents/tools with custom skills directories, or override the default path for any built-in tool.
  64. - **Backup & multi-device sync** — Connect a private GitHub repository with one sign-in (or any Git remote), and the app backs your library up automatically and keeps all connected devices in sync. Merges are skill-aware — a rename on one machine combines cleanly with an edit on another — and true conflicts never block: your local version stays put until you choose keep mine / use remote / keep both. Snapshot versions are restorable at any time.
  65. - **Activity log & Export Logs** — Install / remove / update / sync operations are recorded locally. Use **Settings → Export Logs** to bundle recent logs and activity history into a single zip for easier issue reports.
  66. - **Flexible app settings** — Configure repo path, sync mode, theme, text size, language, tray behavior, proxy, Git remote, update checks, and the order agents appear throughout the app — all in one place.
  67. - **In-app updates** — The app tells you when a new version is out and installs it for you on macOS and Windows. Nothing downloads or installs on its own: checking only notifies, and installing and restarting each take a click.
  68. ## Install
  69. ### macOS
  70. Install with [Homebrew](https://brew.sh):
  71. ```bash
  72. brew install --cask skills-manager
  73. ```
  74. You can also download the `.dmg` for your Mac from the [latest release](https://github.com/xingkongliang/skills-manager/releases/latest).
  75. ### Windows and Linux
  76. Download the installer for your platform from the [latest release](https://github.com/xingkongliang/skills-manager/releases/latest): `.exe` or `.msi` for Windows, and `.AppImage`, `.deb`, or `.rpm` for Linux (x64 and arm64).
  77. On Windows you can also install with [Scoop](https://scoop.sh):
  78. ```powershell
  79. scoop bucket add extras
  80. scoop install extras/skills-manager
  81. ```
  82. Every installer ships the CLI inside the app — see [Where the binary lives](#where-the-binary-lives).
  83. ## Quick Start
  84. 1. Install skills from local folders, Git repositories, archives, or the marketplace.
  85. 2. Open **Global Workspace** from the sidebar and pick an agent (e.g. Claude Code).
  86. 3. Click a **Preset** pill to activate its skills for that agent, or use **+ Add Skills** to pick from your library and toggle target agents inline. Active presets show a ✓; partial installs show a count badge.
  87. 4. To manage project-local skills, open a **Project Workspace** and use the same preset pills or the **+ Add Skills** picker with its multi-agent target selector.
  88. 5. Configure agent paths, custom tools, theme, language, proxy, and Git preferences in **Settings**.
  89. 6. If you want history or multi-machine sync, open **Backup** in the sidebar and click **Sign in with GitHub** — backup and cross-device sync run automatically from then on.
  90. ## Let your agents manage skills
  91. Claude Code, Codex, Cursor and the rest can install a skill, deploy it to another agent, or report what is where — by driving Skills Manager rather than writing into an agent's folder behind its back. That is what keeps source metadata, preset membership, update tracking and cross-agent deployment state intact.
  92. The Dashboard offers a one-time setup: pick the agents that should be able to do it, and the app installs the [`manage-skills`](skills/manage-skills/SKILL.md) skill and deploys it to exactly those. Afterwards it is an ordinary library skill — adding or removing an agent is the agent badge row on its own card. No PATH setup is involved: the app publishes a copy of its CLI where agents look for it.
  93. It is also an ordinary published skill, so it can be installed without the app:
  94. ```bash
  95. npx skills add xingkongliang/skills-manager
  96. ```
  97. ## Backup & Multi-Device Sync
  98. The **Backup** page (sidebar) keeps your skill library versioned in a Git repository. One device gets versioned backup with restorable snapshots; several devices connected to the same repository stay in sync with each other automatically. The remote stays a plain Git repository — you can `git clone` it anywhere, no lock-in.
  99. ### Connect
  100. - **Sign in with GitHub** (recommended): an 8-digit device-flow sign-in creates a private `skills-manager-backup` repository for you. The token is stored in the OS keychain — never in files or the repo config.
  101. - **Advanced**: paste any Git URL (HTTPS + PAT, SSH, self-hosted) under **Settings → Git Sync Configuration**.
  102. - On a new machine with an empty library, the first launch asks: **start fresh, or restore from a backup?**
  103. ### How syncing works
  104. - **Automatic**: local changes are committed and pushed in the background a couple of minutes after you stop editing; updates pushed by your other devices are merged in and pushed back automatically. **Back Up Now** is always available for an immediate run, and every backup in the history shows which device made it.
  105. - **Skill-aware merging**: changes are merged per skill, not per text line — renaming a skill on one machine combines cleanly with editing its content on another.
  106. - **Conflicts never block or overwrite**: if the same skill was edited on two devices at once, everything else syncs normally while that skill keeps your local version and appears under **Needs attention** (also badged on its card in the Library). Pick **keep mine / use remote / keep both** — a safety snapshot is taken before any choice is applied, so every decision is undoable.
  107. - **Snapshots & restore**: manual backups create snapshot versions; open the Backup page history to restore any of them. A restore first saves the current state as its own snapshot.
  108. ### What's included
  109. Skills, tags, presets, and per-agent skill toggles are backed up. Secrets (API keys, tokens, proxy settings) and machine-specific wiring never leave the machine. Skills over 100 MB stay local and are excluded from backup automatically (labeled on the Backup page). The SQLite database is not in Git — it stores metadata that is rebuilt from the skill files.
  110. ### Disconnecting
  111. The Backup page offers three levels: **disconnect this machine** (other devices and remote data untouched), **revoke the GitHub authorization**, or **delete the remote backup** entirely (routed through GitHub's own type-the-name confirmation).
  112. ## Supported Tools
  113. 56 agents are supported out of the box, including:
  114. Claude Code · Codex · Cursor · GitHub Copilot · Gemini CLI · GitLab Duo · OpenCode · OpenClaw · Hermes Agent · OpenHands · Cline · Goose · Windsurf · Continue · Grok · Antigravity · Qwen Code · ZCode · Crush · Kilo Code · Roo Code · Amp · Kiro CLI · Droid · TRAE IDE · Warp · Qoder · CodeBuddy · MiniMax Code
  115. **Settings** lists them all, leading with the ones detected on your machine. You can also add custom tools there and manage their skills the same way.
  116. ## Tech Stack
  117. | Layer | Tech |
  118. |-------|------|
  119. | Frontend | React 19, TypeScript, Vite, Tailwind CSS |
  120. | Desktop | Tauri 2 |
  121. | Backend | Rust |
  122. | Storage | SQLite (`rusqlite`) |
  123. | i18n | react-i18next |
  124. ## Getting Started
  125. ### Prerequisites
  126. - Node.js 20.19+ or 22.12+ (required by Vite 7)
  127. - Rust 1.77.2 or newer
  128. - [Tauri prerequisites](https://v2.tauri.app/start/prerequisites/) for your OS
  129. ### Development
  130. ```bash
  131. npm install
  132. npm run tauri:dev
  133. ```
  134. ### CLI
  135. The repository includes an agent-friendly CLI built on the same Rust shared core used by the desktop app. Both the CLI and the desktop app go through the same SQLite database, central library, and sync engine.
  136. ```bash
  137. # Look around
  138. npm run cli -- skills list
  139. npm run cli -- skills show db
  140. # Install into the library (does NOT deploy to any agent by itself)
  141. npm run cli -- skills install ./my-skill
  142. npm run cli -- skills install https://github.com/foo/bar/tree/main/skills/baz
  143. npm run cli -- skills install vercel-labs/agent-skills@react-best-practices
  144. npm run cli -- skills install https://www.skills.sh/site/uizze.com/ui-radar # website-synced skill
  145. # Put it into the agents that should have it, then check
  146. npm run cli -- skills deploy react-best-practices --agent claude_code --agent codex
  147. npm run cli -- skills status react-best-practices
  148. # Pull upstream changes, and adopt what an agent already has
  149. npm run cli -- skills check --all
  150. npm run cli -- skills update --all
  151. npm run cli -- skills adopt ~/.claude/skills --dry-run
  152. ```
  153. `--help` on any group or subcommand prints the full surface — the groups below
  154. each carry more than these examples show. `--dry-run` is available on selected
  155. commands, including `skills deploy/undeploy/sync/remove/adopt` and
  156. `presets deploy/undeploy/delete`; check each subcommand's help before using it.
  157. `skills remove` requires `--yes` for actual deletion.
  158. Available command groups:
  159. - `repo` — inspect or change the configured base directory
  160. - `agents` (`tools` alias) — list agents, globally enable or disable them, and add custom agents (`add-custom`)
  161. - `skills` — manage the central library and real per-agent deployments (`deploy / undeploy / status`)
  162. - `presets` — create, update, delete, organize, deploy, undeploy, and inspect presets
  163. - `git` — operate on the git-backed `skills/` repository (`clone`, `pull`, `push`, `commit`, `versions`, `restore`)
  164. Extra flags:
  165. - `--skills-root <path>` — operate on a cloned/exported skills repo directly instead of the local app default. The manager's state (DB, presets, cache, logs) lives in `~/.skills-manager/external/<name>-<hash>/`, namespaced by the canonical path of the skills root, so the external checkout itself stays clean.
  166. - `--json` — machine-readable output for scripts/agents. Failures print `{"ok": false, "code": …, "message": …}` on stderr with a non-zero exit. A deployment refused because the target is not ours carries the paths as data (`code: "TARGET_CONFLICT"`, `details.conflicts[].path`) so a caller can name the directory in the way instead of quoting a sentence.
  167. ```bash
  168. npm run -s cli -- --skills-root /path/to/my-skills --json skills list
  169. ```
  170. #### Agents inside WSL
  171. The Windows app cannot create links inside WSL, so it can only copy skills there. If your agents live in WSL, run the Linux CLI inside WSL instead — it keeps its own library there and deploys with real symlinks:
  172. ```bash
  173. mkdir -p ~/.local/bin && curl -L -o ~/.local/bin/skills-manager-cli \
  174. https://github.com/xingkongliang/skills-manager/releases/latest/download/skills-manager-cli-Linux-x64
  175. chmod +x ~/.local/bin/skills-manager-cli
  176. export PATH="$HOME/.local/bin:$PATH"
  177. skills-manager-cli agents add-custom hermes-work --path ~/.hermes/profiles/work/skills
  178. skills-manager-cli skills install ./my-skill
  179. skills-manager-cli skills deploy my-skill --agent hermes-work
  180. ```
  181. #### Where the binary lives
  182. At startup the app publishes a copy of its own CLI to `~/.skills-manager/bin/skills-manager-cli`, always matching the running app, so agents can find it without anything on your PATH. A `.version` stamp beside it is written only after the copy is verified and removed before each republish, so a copy that failed — a binary held open on Windows, say — is never presented as usable.
  183. Putting the CLI on your *own* PATH, for typing commands yourself, is separate:
  184. ```bash
  185. npm run cli:install
  186. # equivalent to:
  187. # cargo install --path src-tauri --bin skills-manager-cli --locked --force
  188. ```
  189. This drops the binary at `~/.cargo/bin/skills-manager-cli`. Re-run after pulling updates to refresh it.
  190. Official releases also publish standalone CLI binaries for macOS arm64/x64, Windows x64, and Linux x64. Download the matching `skills-manager-cli-*` asset, make it executable on macOS/Linux, and place it on PATH.
  191. #### Concurrent use with the desktop app
  192. The CLI and desktop app share the same SQLite database and repository lock. The app's filesystem watcher normally refreshes after CLI metadata or deployment changes. If the app was suspended while a command ran, trigger one manual refresh.
  193. ### Build
  194. ```bash
  195. npm run tauri:build
  196. npm run cli:build
  197. ```
  198. ## Troubleshooting
  199. **macOS refuses to open the app.** Releases from **v1.29.0** onward are signed with an Apple Developer ID certificate and notarized, so they open normally. If you see "Apple could not verify…" or "App is damaged", you are on v1.28.5 or older — upgrading is the fix. (Upgrading changes the code signature, so macOS may ask once more for the `skills-manager-git-backup` keychain entry; click **Always Allow**.)
  200. Anything else — [open an issue](https://github.com/xingkongliang/skills-manager/issues), and attach the bundle from **Settings → Export Logs**.
  201. ## Star History
  202. <p align="center">
  203. <a href="https://github.com/xingkongliang/star-history-svg">
  204. <img src="assets/star-history.svg" width="800" alt="Star History chart for xingkongliang/skills-manager" />
  205. </a>
  206. </p>
  207. ## License
  208. MIT

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.