Skip to content
Back to search

skills-manager

A native macOS app to manage skills across coding agents — Claude Code, Cursor, Copilot CLI, Codex, Gemini CLI

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/yibie--skills-manager/badge.svg)](/listings/yibie--skills-manager)

HTML

<a href="/listings/yibie--skills-manager"><img src="/api/listings/yibie--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.

Download [Skills Manager 2.0.0](../../releases/download/v2.0.0/SkillsManager-v2.0.0.zip) and drag it to Applications. The universal app is Developer ID signed, Apple-notarized, and accepted by Gatekeeper. SHA-256: `8da1f38838119864e593e9e591355dd53b5d407e4a7383aac68f095efdac1ad5`.

Upgrading from 1.x? Read the [2.0.0 upgrade and rollback guide](docs/releases/2.0.0.md) first. All releases remain available on the [Releases](../../releases) page.

Or build from source:

git clone https://github.com/yibie/skills-manager.git
cd skills-manager
open SkillsManager.xcodeproj

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 · 204 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 native macOS app to manage skills across all your coding agents — Claude Code, Cursor, Codex, Gemini CLI, Qwen Code, Roo Code, Continue, OpenHands, OpenClaw, and more.
  3. **Current source version: 2.0.0 (build 200).**
  4. <img src="SkillsManager_Logo.png" width="80" alt="Skills Manager Icon">
  5. ---
  6. ## Screenshots
  7. ![Collections Control Center](docs/screenshots/control-center.png)
  8. *Organize Library skills into Collections, then mount them into agents without moving or duplicating the originals*
  9. ![Mounted Collection](docs/screenshots/collection-detail.png)
  10. *Inspect Collection membership and mounted agents while keeping missing or diverged state visible*
  11. ---
  12. ## What's new in 2.0.0
  13. Version 2.0 turns Skills Manager from a directory browser into a local skill lifecycle control plane built around `Library → Collection → Mount`.
  14. ```text
  15. Library trusted, managed skill sources
  16. ↓
  17. Collection reusable groups for a project or workflow
  18. ↓
  19. Mount links a Collection into one or more agents on demand
  20. ```
  21. ### From 1.x to 2.0
  22. | Area | 1.x | 2.0 |
  23. |------|-----|-----|
  24. | Product model | Browse and manage agent skill directories | Manage the complete local skill lifecycle |
  25. | Organization | Skills live primarily inside each agent directory | A managed Library supplies reusable Collections |
  26. | Multi-agent use | Install and maintain skills for each agent separately | Mount or unmount a Collection without moving or duplicating its Library skills |
  27. | State | Primarily installed or not installed | Missing, shared, partially applied, and diverged states remain visible and can be reapplied explicitly |
  28. | Identity | Names and paths do most of the matching | Durable skill IDs connect upgrades, Collections, stars, the macOS app, and the TUI |
  29. | Ownership and recovery | Basic provider install and removal flows | Provider ownership is preserved; takeover keeps recoverable backups and refuses ambiguous destructive repairs |
  30. | Navigation | Directory-oriented agent views | Agent home pages, conflict diagnosis, full-site Discover search, Copy ID, Copy Path, and Show in Finder |
  31. | Agent support | Core agent scanning and installation | A broader registry, including first-class XDG-aware OpenCode support and correctly classified neutral shared roots |
  32. | Localization | UI strings did not have a consistent English fallback | English is the source and fallback language; macOS can select the bundled Simplified Chinese localization |
  33. The architecture remains local-first: there is no Skills Manager backend, unmounting never deletes the Library copy, and network access is limited to features such as Discover, translation fallback, and LLM Try calls.
  34. ## What it does
  35. Coding agent skills are scattered everywhere. Each agent has its own format, install path, and management story. Skills Manager brings them together in one place.
  36. - **Discover** skills from [skills.sh](https://skills.sh/) and community repositories, including full-site search beyond the initially loaded list
  37. - **Install** to one or multiple agents at once
  38. - **Try** skills with your own LLM (Claude, OpenAI, OpenRouter, Ollama, or LM Studio) before installing
  39. - **Manage** installed skills regardless of where they came from — update or remove through the detected provider, star favorites (stars are shared with the terminal UI), and spot diverged same-name copies across agents (Conflicts)
  40. - **Group skills into collections** and mount a collection into an agent only when needed — symlinks in, links out, the library stays put (sidebar → Control Center)
  41. - **Monitor** agent skill directories and refresh automatically when they change on disk
  42. - **Agent home pages** — clicking an agent in the sidebar opens its home: detection status and skills directory (Show in Finder / Copy Path), conflicts involving that agent, and its full skill list
  43. - **Translate** discovered skill summaries with a bundled 8-language catalog and on-demand LLM fallback for newly loaded entries
  44. ## Requirements
  45. - macOS 14 (Sonoma) or later
  46. - One or more coding agents installed (Claude Code, Cursor, Copilot CLI, Codex, Gemini CLI…)
  47. ## Installation
  48. Download [Skills Manager 2.0.0](../../releases/download/v2.0.0/SkillsManager-v2.0.0.zip) and drag it to Applications. The universal app is Developer ID signed, Apple-notarized, and accepted by Gatekeeper. SHA-256: `8da1f38838119864e593e9e591355dd53b5d407e4a7383aac68f095efdac1ad5`.
  49. Upgrading from 1.x? Read the [2.0.0 upgrade and rollback guide](docs/releases/2.0.0.md) first. All releases remain available on the [Releases](../../releases) page.
  50. Or build from source:
  51. ```bash
  52. git clone https://github.com/yibie/skills-manager.git
  53. cd skills-manager
  54. open SkillsManager.xcodeproj
  55. ```
  56. ## Supported Agents
  57. Skills Manager detects and scans every agent below through `AgentRegistry`. The `Install target` column marks agents that are available in the current multi-install picker; the remaining agents are still detected and scanned from their registered skills directory when installed locally.
  58. | Agent | Registry ID | Install target |
  59. |-------|-------------|----------------|
  60. | Claude Code | `claude-code` | Yes |
  61. | Amp | `amp` | Scan |
  62. | Cline | `cline` | Scan |
  63. | Codex | `codex` | Yes |
  64. | Cursor | `cursor` | Yes |
  65. | Deep Agents | `deepagents` | Scan |
  66. | Firebender | `firebender` | Scan |
  67. | Gemini CLI | `gemini-cli` | Yes |
  68. | GitHub Copilot | `github-copilot` | Yes |
  69. | Kimi Code CLI | `kimi-cli` | Scan |
  70. | Replit | `replit` | Scan |
  71. | Warp | `warp` | Scan |
  72. | Antigravity | `antigravity` | Scan |
  73. | Augment | `augment` | Yes |
  74. | IBM Bob | `bob` | Scan |
  75. | CodeBuddy | `codebuddy` | Scan |
  76. | Command Code | `command-code` | Yes |
  77. | Continue | `continue` | Yes |
  78. | Cortex Code | `cortex` | Scan |
  79. | Crush | `crush` | Scan |
  80. | Droid | `droid` | Scan |
  81. | Goose | `goose` | Scan |
  82. | iFlow CLI | `iflow-cli` | Yes |
  83. | Junie | `junie` | Scan |
  84. | Kilo Code | `kilo` | Yes |
  85. | Kiro CLI | `kiro-cli` | Yes |
  86. | Kode | `kode` | Scan |
  87. | MCPJam | `mcpjam` | Yes |
  88. | Mistral Vibe | `mistral-vibe` | Scan |
  89. | Mux | `mux` | Yes |
  90. | Neovate | `neovate` | Yes |
  91. | OpenCode | `opencode` | Yes |
  92. | OpenHands | `openhands` | Yes |
  93. | Pi | `pi` | Yes |
  94. | Pochi | `pochi` | Scan |
  95. | Qoder | `qoder` | Scan |
  96. | Qwen Code | `qwen-code` | Yes |
  97. | Roo Code | `roo` | Yes |
  98. | Trae | `trae` | Scan |
  99. | Trae CN | `trae-cn` | Scan |
  100. | Windsurf | `windsurf` | Scan |
  101. | Zencoder | `zencoder` | Scan |
  102. | AdaL | `adal` | Scan |
  103. | OpenClaw | `openclaw` | Scan |
  104. OpenCode uses `$XDG_CONFIG_HOME/opencode/skills` (or `~/.config/opencode/skills` when `XDG_CONFIG_HOME` is unset). **Import Folder** expects the agent's exact skills directory and uses it for both scanning and future installs.
  105. `$XDG_CONFIG_HOME/agents/skills` and `~/.agents/skills` are neutral shared roots. OpenClaw-specific discovery is limited to its `clawd`, npm-global, and workspace-main roots so shared skills are not mislabeled as OpenClaw.
  106. ## Discover and Translation
  107. Discover starts fast from a local cache at `~/.skills-manager/cache/discover-directory.json`, then refreshes from skills.sh in the background. Search uses the skills.sh full-site API when online and falls back to cached query snapshots when offline.
  108. The app bundles a generated description translation catalog covering 8 languages (English, Simplified/Traditional Chinese, Japanese, Korean, French, German, Spanish) and still keeps an on-demand translation button as a temporary fallback for newly loaded or uncached descriptions. Local Ollama and LM Studio endpoints are normalized to IPv4 loopback (`127.0.0.1`) at runtime to avoid macOS `localhost` resolving to IPv6 `::1`.
  109. ## Architecture
  110. Pure local architecture — no backend, works offline except for network-backed features like Discover refresh/search, detail loading, translation fallback, and LLM Try calls. Reads and writes agent config files directly. The terminal UI additionally keeps a local Git history of skill installs for version management (diff and rollback).
  111. The macOS app owns the lifecycle:
  112. - `skills.sh` supplies discovery data only. Installing from Discover downloads the GitHub skill package directly, preserves its scripts/assets, writes it to the managed Library, and creates agent links without requiring Node or `npx`.
  113. - Skills installed by the Vercel Skills CLI are recognized from its global v3 lock file and managed through that provider when `npx` is available.
  114. - If that provider is unavailable, an update can move the existing provider copy to Trash and adopt the refreshed package into the managed Library; native removal also clears stale provider metadata.
  115. - Unmount removes agent links but keeps the Library copy. Delete from Library is a separate confirmed operation. External OpenClaw/plugin content is moved to macOS Trash rather than permanently deleted.
  116. Built with SwiftUI + Swift 6, SwiftData, macOS 14+.
  117. ## Terminal UI
  118. The repository also includes a terminal UI in `tui/`.
  119. Current status:
  120. - **Blessed TUI:** complete for the current scope and treated as the primary terminal implementation
  121. - **Ink TUI:** historical backup/reference only, no longer the target runtime
  122. Official CLI command:
  123. ```bash
  124. cd tui
  125. npm exec skills-manager
  126. ```
  127. For a global command, run once inside `tui/`:
  128. ```bash
  129. npm link
  130. ```
  131. Then launch from anywhere with:
  132. ```bash
  133. skills-manager
  134. ```
  135. The Blessed TUI currently supports:
  136. - three-panel keyboard-first navigation
  137. - discover via [skills.sh](https://skills.sh/)
  138. - install / uninstall / star (direct install currently targets Claude Code; Discover installs can target multiple agents; stars sync with the macOS app via `~/.skills-manager/tui-state.json`)
  139. - source-file opening and discover source-page opening
  140. - search, detail overlays, full refresh
  141. - version history with diff and rollback (press `H`)
  142. - local / plugin differentiation, including Codex plugin cache and Pi package resources
  143. ## Roadmap
  144. - [ ] Auto-update detection for discovered skills
  145. - [x] Skill conflict detection across agents
  146. - [ ] Export / import skill sets
  147. - [ ] Team sync via shared skills repository
  148. ## Contributing
  149. Issues and PRs welcome. See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.
  150. ## License
  151. MIT — see [LICENSE](LICENSE).

Ratings and comments

Sign in to rate this skill.

Sign in

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