xingkongliang/skills-manager

Skills Manager – What it is

Skills Manager is a desktop (macOS, Windows, Linux) and CLI tool that lets you keep a single library of AI‑agent “skills” (code snippets, prompts, extensions) and deploy them to many coding assistants such as Claude Code, Codex, Cursor, GitHub Copilot, Gemini‑CLI, etc. It handles installation from Git repos, local folders or a public marketplace, tracks versions, lets you group skills into presets, and synchronises the whole library across devices via a private Git backup.

---

Core concepts

Concept	What it does
Unified skill library	All skills live under one folder (default ~/.skills-manager). You can add them from Git, zip files, local directories or the built‑in marketplace.
Agents / tools	Each AI coding assistant is an agent (Claude Code, Codex, Cursor …). The app knows where each agent expects its skills and can copy or symlink them automatically.
Workspaces	Global (shows every skill an agent can see), Project (local per‑project skill folders), and Linked (any arbitrary directory) views for managing installations.
Presets	Named groups of skills. Clicking a preset instantly enables or disables the whole set for the selected agent(s).
Backup & multi‑device sync	A private GitHub repo (or any Git remote) stores the library. Changes are auto‑committed, merged skill‑wise, and propagated to all logged‑in machines.
CLI	The same Rust core is exposed as a command‑line tool (skills-manager-cli) for scripts or agents to query/install/update skills.

---

What you can do with it

• Browse & install skills from the built‑in marketplace or your own sources.
• Activate a preset with one click, or pick individual skills from the library and target any subset of agents.
• Sync across machines automatically; resolve conflicts with a UI that keeps your local copy safe.
• Export logs for debugging or issue reports.
• Add custom agents if you have a tool that stores skills in a non‑standard location.
• Update Git‑based skills when upstream changes are available.
• Backup large skills (> 100 MB) are kept locally but the rest of the library is versioned.

---

Quick start (desktop)

1. Install the app (Homebrew on macOS or download the installer for Windows/Linux).
2. Open the Global Workspace, pick an agent (e.g., Claude Code).
3. Click a Preset pill to enable its skills, or press + Add Skills to select individual ones from your library.
4. For project‑specific needs, open a Project Workspace and repeat the same steps.
5. To enable sync, go to Backup → Sign in with GitHub – a private repo is created and your library is versioned automatically.

---

Quick start (CLI)

# List all skills in the central library
skills list

# Install a new skill from a Git repo
skills install https://github.com/foo/bar/tree/main/skills/baz

# Deploy a skill to specific agents
skills deploy baz --agent claude_code --agent codex

# Check for upstream updates and apply them
skills check --all
skills update --all

All commands support --json for machine‑readable output and --dry-run for safe previews.

---

Installation

• macOS – brew install --cask skills-manager or download the latest .dmg.
• Windows / Linux – download the appropriate installer (.exe, .msi, .AppImage, .deb, .rpm) from the releases page.
• The installer also places the CLI (skills-manager-cli) under ~/.skills-manager/bin/ and optionally in ~/.cargo/bin/ via npm run cli:install.

---

Tech stack (for developers)

• Frontend – React 19 + TypeScript + Vite + Tailwind CSS
• Desktop shell – Tauri 2 (Rust backend, SQLite metadata store)
• CLI – Rust binary sharing the same core as the app
• i18n – react‑i18next (English & Chinese UI)

---

License

MIT – free to use, modify, and distribute.