Skip to content
Back to search

Skills-Manager

Free, open-source desktop manager for AI Agent Skills. Write a skill once, sync it to 32 AI coding tools (Claude Code, Codex, Cursor, Gemini CLI, and more) via symlinks. Local-first, MIT licensed. macOS, Windows, Linux.

Safety scan

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

Checked today
Badge for your README
findsafeskills safety rating

Markdown

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

HTML

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

Install

i

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 · 169 lines

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

  1. # Skills Manager
  2. > **A unified desktop application for managing AI coding assistant skills.**
  3. > Seamlessly organize, sync, and share skills for **Claude Code, Codex, Opencode** and other AI tools.
  4. ![Version](https://img.shields.io/badge/version-2.2.0-blue) ![Downloads](https://img.shields.io/github/downloads/jiweiyeah/skills-manager/total?color=brightgreen&label=downloads) ![Platform](https://img.shields.io/badge/platform-macOS%20%7C%20Windows%20%7C%20Linux-lightgrey) ![Tech](https://img.shields.io/badge/built%20with-Tauri%202.0%20%2B%20React%2019-orange)
  5. [**Website**](https://skillsmanager.freeourdays.com/?ref=gh) · [中文说明](./README_CN.md)
  6. ## 🤝 Sponsors
  7. **[Y-API](https://y-api.bestvirtualgoods.com/i/DNTXWYCU)** provides a unified API for models from DeepSeek, Qwen, GLM, Kimi, OpenAI, and more.
  8. - **Easy integration**: OpenAI-compatible, so you can keep using your existing OpenAI SDK and access multiple models with one API key.
  9. - **Flexible billing**: Pay per token, with no monthly fee or minimum spend.
  10. - **Easy to try**: Signup credits let you get started without a credit card.
  11. ## 📖 Introduction
  12. **Skills Manager** is a modern desktop application designed to solve the fragmentation of AI assistant skills configurations. Instead of managing skills and prompts separately for different tools, Skills Manager provides a central hub.
  13. It uses a powerful **symlink synchronization mechanism**, allowing you to write a skill once and instantly use it across 32 supported AI tools including Claude Code, Codex, Cursor, Gemini CLI, Windsurf, Trae, and more.
  14. ## ✨ Key Features
  15. - **🎯 Unified Management**: Centralize all your AI skills in one secure location.
  16. - **🔄 Smart Synchronization**: Automatic symlink management ensures your tools always have the latest version of your skills without file duplication.
  17. - **🎛️ Granular Control**: Enable or disable specific skills for individual tools without deleting the original files.
  18. - **🛒 Marketplace**: Browse, install, and share community-contributed skills directly within the app.
  19. - **🌐 AI Translation**: Translate skill names, descriptions, and content into your preferred language using LLM.
  20. - **⌨️ Command Palette**: Quick navigation and actions via `⌘K` / `Ctrl+K`.
  21. - **🌍 Bilingual UI**: Full English and Chinese interface support.
  22. - **⚡ High Performance**: Built with **Rust** and **Tauri 2.0** for a lightweight, blazing-fast experience.
  23. - **🛡️ Cross-Platform**: Native support for macOS, Windows, and Linux.
  24. - **🔌 Multi-Tool Support**: Out-of-the-box support for 32 AI tools (Claude Code, Codex, Cursor, Gemini CLI, Windsurf, Trae, Cline, Augment, Goose, and many more), extensible via custom tools.
  25. - **🧩 Custom Tools**: Add your own tools with custom paths and optional icons.
  26. - **🎨 Modern UI**: Beautiful Raycast-style interface built with React 19, Tailwind CSS v4, and Radix UI.
  27. ## 📸 Screenshots
  28. <p align="center">
  29. <img src="https://image.freeourdays.com/sk1.png" alt="应用截图 1" ">
  30. <img src="https://image.freeourdays.com/sk2.png" alt="应用截图 2" ">
  31. <img src="https://image.freeourdays.com/sk3.png" alt="应用截图 3" ">
  32. </p>
  33. ## 📥 Download
  34. Get the build for your platform from the **[official website](https://skillsmanager.freeourdays.com/?ref=gh#download)**, which detects your OS and architecture automatically, or pick a file yourself on the **[Releases Page](../../releases)**.
  35. | OS | Installer Type |
  36. |----|----------------|
  37. | **macOS** | `.dmg` — separate builds for Apple Silicon (`aarch64`) and Intel (`x64`) |
  38. | **Windows** | `.msi` / `.exe` |
  39. | **Linux** | `.deb` / `.AppImage` / `.rpm`|
  40. ### Homebrew (macOS)
  41. ```bash
  42. brew tap jiweiyeah/tap
  43. brew install --cask jiweiyeah/tap/skills-manager
  44. ```
  45. The cask picks the right build for your CPU automatically, and `brew upgrade` keeps it current.
  46. Use the full `jiweiyeah/tap/skills-manager` path: Homebrew's official cask repository contains an unrelated cask that happens to share the `skills-manager` token, and the official tap wins on a bare name.
  47. The app is ad-hoc signed but **not notarized by Apple**, so the cask strips the quarantine attribute on install — see the [tap README](https://github.com/jiweiyeah/homebrew-tap) for what that means and how to opt out.
  48. ## 🪟 Windows Notes
  49. **You do not need Administrator rights.** When a skill is enabled for a tool, Skills Manager tries three strategies in order:
  50. 1. **Directory symlink** — used when Developer Mode is enabled (or when the app happens to run elevated).
  51. 2. **Directory junction** (`mklink /J`) — the normal path on a standard account. It needs no special permission.
  52. 3. **Tracked copy** — if junctions are blocked as well, the folder is copied and its source path is recorded in `.skills-manager-source.json`, so the copy stays traceable and can still be disabled from the app.
  53. A standard, non-elevated Windows account is enough for all three.
  54. If a tool is **not detected**, elevation will not help either: the tool's own config directory has to exist on this machine. Check the [tool compatibility matrix](https://skillsmanager.freeourdays.com/?ref=gh#tools) for the exact path each tool reads, or add it manually as a custom tool.
  55. ## 🚀 Getting Started
  56. 1. **Install**: Run the installer for your platform.
  57. 2. **Setup**: On first launch, the app will guide you to select your skills storage directory.
  58. 3. **Sync**: The app automatically detects installed AI tools (like Claude Code) and links your skills.
  59. ## ⌨️ CLI (`skm`)
  60. A companion command-line tool ships with every release for terminal-first workflows: SSH/headless machines, dotfiles setup scripts, and quick status checks. It reads and writes the same config and symlinks as the desktop app, so they can be used interchangeably.
  61. Download `skm-<target>.tar.gz` (`.zip` on Windows) from the [Releases Page](../../releases), extract it, and put the binary on your `PATH`.
  62. ```bash
  63. skm init # first-run setup without the GUI (writes config, detects tools)
  64. skm adopt [--dry-run] [--yes] # move skills already in tool dirs into the hub and relink them
  65. skm list [--tool <id>] [--json] # list skills and their per-tool link status
  66. skm enable <skill> --for <tool> # create the symlink (e.g. skm enable ab-testing --for claude)
  67. skm disable <skill> --for <tool> # remove the symlink
  68. skm doctor [--json] # detect installed tools + report sync issues
  69. skm fix --yes # repair sync issues found by doctor
  70. ```
  71. Both `<skill>` and `<tool>` accept a unique prefix (`claude` matches `claude-code`). Run `skm <command> --help` for details. The GUI is optional: `skm init` + `skm adopt` give a fully terminal-only workflow (e.g. on headless servers).
  72. Installing the CLI (Settings → Command Line Tool, or `skm init`) also copies the [`skills-manager-cli`](./skills/skills-manager-cli) companion skill into the hub and enables it for every currently detected tool, so other agents can drive `skm` without guessing flags. It covers `--json` contracts, dry-run vs apply, and which commands `skm` does *not* implement.
  73. The same companion skill is published to [ClawHub](https://clawhub.ai/jiweiyeah/skills/skills-manager-cli) automatically on every version bump, so agents that pull skills from the marketplace instead of the app always get instructions matching the current `skm`. The release job runs `npm run publish:skill`; it queries ClawHub first and only uploads when the local version is strictly newer, so re-runs are no-ops. Use `npm run publish:skill -- --dry-run` to validate the file list and version gate without uploading.
  74. ## ❗ Linux Troubleshooting
  75. If you encounter a **blank white screen** when launching the `.AppImage` on Linux (especially in virtual machines like VMware/VirtualBox), it is likely a WebKitGTK hardware acceleration issue.
  76. Please run the application from the terminal with the following command:
  77. ```bash
  78. WEBKIT_DISABLE_COMPOSITING_MODE=1 ./Skills-Manager_<version>_amd64.AppImage
  79. ```
  80. ## 🛠️ Technology Stack
  81. Designed for developers who care about performance and stability:
  82. - **Core**: [Tauri 2.0](https://tauri.app/) (Rust)
  83. - **Frontend**: [React 19](https://react.dev/) + TypeScript
  84. - **Styling**: [Tailwind CSS v4](https://tailwindcss.com/)
  85. - **UI Components**: [Radix UI](https://www.radix-ui.com/)
  86. - **Editor**: [Monaco Editor](https://microsoft.github.io/monaco-editor/)
  87. ## 📅 Roadmap
  88. We are actively working on making Skills Manager better. Here is what we are planning:
  89. - [x] Core features (e.g., soft link synchronization, multi-tool support).
  90. - [x] Marketplace – Browse, install, and share community-contributed skills.
  91. - [x] AI translation for skill content.
  92. - [ ] Plugin system to support more AI tool extensions.
  93. - [ ] Integrated AI chat interface for testing Skills directly within the application.
  94. ## 🤝 Contributing & Feedback
  95. We welcome all forms of contribution!
  96. - **Found a bug?** Please submit an issue on our [Issues](../../issues) page.
  97. - **Have a feature request?** We'd love to hear your ideas! Feel free to open an issue to discuss new features.
  98. ## 💝 Support
  99. If this project helps you, feel free to support via QR code.
  100. | WeChat Support QR | Alipay Support QR |
  101. |---|---|
  102. | <img src="https://image.freeourdays.com/2024/WechatIMG276.jpg" alt="WeChat Support QR" height="300" /> | <img src="https://image.freeourdays.com/zfb.jpg" alt="Alipay Support QR" height="300" /> |
  103. Or support via Ko-fi: [ko-fi.com/yeheboo](https://ko-fi.com/yeheboo)
  104. ## 📈 Star History
  105. <a href="https://www.star-history.com/?type=date&repos=jiweiyeah%2Fskills-manager">
  106. <picture>
  107. <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/chart?repos=jiweiyeah/skills-manager&type=date&theme=dark&legend=top-left&sealed_token=maGhqrEwZ51qujlvNPr_FgACgJxDdicoHbnV6FU6K2IQBOo5Cvf_tcX2fdp8o--YQO0Bc240gFYxixCHLDyKy9lrRqTjFMY2rvm77HbLWLY6Q0ETgY89O8oCzsTKjBrL5N9e6kE6RJKp2OQVeBL-v2GRi_VR0CEI2rRKeN3eDnR1ovPjVgXqFakD6LSd" />
  108. <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/chart?repos=jiweiyeah/skills-manager&type=date&legend=top-left&sealed_token=maGhqrEwZ51qujlvNPr_FgACgJxDdicoHbnV6FU6K2IQBOo5Cvf_tcX2fdp8o--YQO0Bc240gFYxixCHLDyKy9lrRqTjFMY2rvm77HbLWLY6Q0ETgY89O8oCzsTKjBrL5N9e6kE6RJKp2OQVeBL-v2GRi_VR0CEI2rRKeN3eDnR1ovPjVgXqFakD6LSd" />
  109. <img alt="Star History Chart" src="https://api.star-history.com/chart?repos=jiweiyeah/skills-manager&type=date&legend=top-left&sealed_token=maGhqrEwZ51qujlvNPr_FgACgJxDdicoHbnV6FU6K2IQBOo5Cvf_tcX2fdp8o--YQO0Bc240gFYxixCHLDyKy9lrRqTjFMY2rvm77HbLWLY6Q0ETgY89O8oCzsTKjBrL5N9e6kE6RJKp2OQVeBL-v2GRi_VR0CEI2rRKeN3eDnR1ovPjVgXqFakD6LSd" />
  110. </picture>
  111. </a>
  112. ---
  113. *Made with ❤️ for the AI developer community.*

Ratings and comments

Sign in to rate this skill.

Sign in

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