Skills Manager

One app to manage AI agent skills across all your coding tools.

中文说明  ·  @JayTL00 on X  ·  Buy me a coffee

My Skills

Install Skills — Marketplace

Projects

Settings

Features

• Unified skill library — Install skills from Git repos, local folders, .zip / .skill archives, or the skills.sh marketplace. Everything goes into one central repo at ~/.skills-manager.
• Marketplace + AI search — Browse popular skills from the marketplace, run keyword search, or enable SkillsMP AI search with your API key.
• Multi-tool sync — Sync skills to any supported tool via symlink or copy with a single click.
• 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.
• 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 scenario sync.
• Scenarios — Group skills into scenarios, configure per-scenario agent toggles, drag to reorder enabled skills, and switch between setups instantly.
• Batch operations — Multi-select skills for bulk enable/disable, export, or delete.
• Skill tagging and filters — Tag skills, filter by source or tag, and narrow large libraries quickly.
• Update tracking — Check for upstream updates on Git-based skills; re-import local ones.
• Skill preview and source inspection — Read SKILL.md / README.md, inspect source metadata, and compare local content with the upstream version inside the app.
• Custom tools — Add your own agents/tools with custom skills directories, or override the default path for any built-in tool.
• Git backup and restore — Version-control your skill library with Git for backup and multi-machine sync, then restore snapshot versions from Version History when needed.
• Flexible app settings — Configure repo path, sync mode, default scenario, theme, text size, language, tray behavior, proxy, Git remote, and update checks in one place.

Quick Start

1. Create or switch to a scenario for the workflow you want to use.
2. Install skills from local folders, Git repositories, archives, or the marketplace. If you have a SkillsMP API key, you can also turn on AI search.
3. Open My Skills to decide which skills belong to the current scenario, tag them, review docs, and manage per-agent sync.
4. Sync enabled skills to detected tools, or use Project Workspaces to compare project-local skills with your central library and move changes both ways.
5. Configure agent paths, custom tools, sync mode, default scenario, theme, language, proxy, and Git preferences in Settings.
6. If you want history or multi-machine sync, set a Git remote in Settings and run Start Backup or Sync to Git from My Skills.

Git Backup

Back up ~/.skills-manager/skills/ to a Git repo for version history and multi-machine sync.

Quick setup

1. Create a private repository (recommended).
2. Open Settings → Git Sync Configuration and save your remote URL.
3. Open My Skills.
4. Choose one:

• Existing remote: click Start Backup to clone from the configured remote.
• New local repo: click Start Backup to initialize locally, then use Sync to Git.

5. Use Sync to Git from the My Skills toolbar.

Sync to Git automatically handles pull, commit, and push based on current repo status. Each successful sync creates a snapshot version tag. You can open Version History in My Skills, inspect the timeline, and restore any snapshot as a new commit.

Authentication

• SSH URL (git@github.com:...): requires SSH key configured on your machine and added to GitHub.
• HTTPS URL (https://github.com/...): push usually requires a Personal Access Token (PAT).

Note: The SQLite database (~/.skills-manager/skills-manager.db) is not included in Git — it stores metadata that can be rebuilt by scanning the skill files.

Supported Tools

Cursor · Claude Code · Codex · OpenCode · Amp · Kilo Code · Roo Code · Goose · Gemini CLI · GitHub Copilot · Windsurf · TRAE IDE · Antigravity · Clawdbot · Droid

You can also add custom tools in Settings and manage their skills the same way.

In-App Help

The Help button in Settings mirrors the current product flow: scenarios, skill installation, My Skills management, Project Workspaces, Git backup, and environment-level settings. It is intended as the in-app version of this quick-start guide.

Tech Stack

Layer	Tech
Frontend	React 19, TypeScript, Vite, Tailwind CSS
Desktop	Tauri 2
Backend	Rust
Storage	SQLite (rusqlite)
i18n	react-i18next

Getting Started

Prerequisites

• Node.js 18+
• Rust toolchain
• Tauri prerequisites for your OS

Development

npm install
npm run tauri:dev

Build

npm run tauri:build

Troubleshooting

macOS: "App is damaged and can't be opened"

If you see this error after downloading the app, run the following command in Terminal and then open the app again:

xattr -cr /Applications/skills-manager.app

Replace the path with wherever you placed the .app file if it's not in /Applications.

License

MIT