--- slug: "skills-manager" source_type: "readme" source_url: "https://cdn.jsdelivr.net/gh/iamzhihuix/skills-manage@main/README.md" repo: "https://github.com/iamzhihuix/skills-manage" source_file: "README.md" branch: "main" --- # skills-manage `skills-manage` is a Tauri desktop app for managing AI coding agent skills across multiple platforms from one place. [中文文档](https://github.com/iamzhihuix/skills-manage/blob/HEAD/README_CN.md) > **Disclaimer** > > `skills-manage` is an independent, unofficial desktop application for managing local skill directories and importing public skill metadata. It is not affiliated with, endorsed by, or sponsored by Anthropic, OpenAI, GitHub, MiniMax, or any other supported platform, publisher, or trademark owner. ## Overview `skills-manage` follows the [Agent Skills](https://github.com/anthropics/agent-skills) open pattern and uses `~/.agents/skills/` as the canonical central directory. Skills can then be installed to individual platforms through symlinks, so one source of truth can drive multiple AI coding tools. ## Highlights - Central skill library plus per-platform install and uninstall flows. - Claude Code can surface native skills and read-only marketplace plugin skills in one platform view. - Full skill detail view with Markdown preview, raw source view, and AI explanation generation. - Collections for organizing skills and batch-installing them to platforms. - Discover scan for project-level skill libraries, including an Obsidian sidebar category for vault skills (`.skills/`, `.agents/skills/`, `.claude/skills/`). - Marketplace browsing and GitHub repository import with authenticated requests and retry fallback. - Fast search for large skill libraries with deferred queries, lazy indexing, and virtualization. - Bilingual UI, Catppuccin themes, accent colors, onboarding, and responsive navigation. ## Screenshots ### Central skills and platform installs ![Central skills library view](https://github.com/iamzhihuix/skills-manage/raw/HEAD/images/01.png) ### Review installed skills on a specific platform ![Platform skill view](https://github.com/iamzhihuix/skills-manage/raw/HEAD/images/06.png) ### Discover local project skill libraries ![Discover project skill libraries](https://github.com/iamzhihuix/skills-manage/raw/HEAD/images/03.png) ### Browse marketplace publishers and skills ![Marketplace view](https://github.com/iamzhihuix/skills-manage/raw/HEAD/images/04.png) ### Import skills from a GitHub repository ![GitHub repository import wizard](https://github.com/iamzhihuix/skills-manage/raw/HEAD/images/02.png) ### Organize reusable collections ![Skill collections view](https://github.com/iamzhihuix/skills-manage/raw/HEAD/images/05.png) ## Download - Latest release: - Current prebuilt packages: Apple Silicon macOS (`.dmg` and `.app.zip`) - Other platforms: run from source for now ### macOS Unsigned Build The current public macOS build is not notarized. If macOS shows a warning such as: ![macOS damaged app warning](https://github.com/iamzhihuix/skills-manage/raw/HEAD/images/app-damaged.png) - `"skills-manage" is damaged and can't be opened` - `"skills-manage" cannot be opened because Apple could not verify it` the app is usually not actually corrupted; it is being blocked by Gatekeeper quarantine on an unsigned build. After moving the app to `/Applications`, run: ```bash xattr -dr com.apple.quarantine "/Applications/skills-manage.app" ``` Then launch the app again from Finder. If your app is stored somewhere else, replace the path with the actual `.app` path. ## Supported Platforms | Category | Platform | Skills Directory | |----------|----------|-----------------| | Coding | Claude Code | `~/.claude/skills/` | | Coding | Codex CLI | `~/.agents/skills/` | | Coding | Cursor | `~/.cursor/skills/` | | Coding | Gemini CLI | `~/.gemini/skills/` | | Coding | Trae | `~/.trae/skills/` | | Coding | Factory Droid | `~/.factory/skills/` | | Coding | Junie | `~/.junie/skills/` | | Coding | Qwen | `~/.qwen/skills/` | | Coding | Trae CN | `~/.trae-cn/skills/` | | Coding | Windsurf | `~/.windsurf/skills/` | | Coding | Qoder | `~/.qoder/skills/` | | Coding | Augment | `~/.augment/skills/` | | Coding | OpenCode | `~/.opencode/skills/` | | Coding | KiloCode | `~/.kilocode/skills/` | | Coding | OB1 | `~/.ob1/skills/` | | Coding | Amp | `~/.amp/skills/` | | Coding | Kiro | `~/.kiro/skills/` | | Coding | CodeBuddy | `~/.codebuddy/skills/` | | Coding | Hermes | `~/.hermes/skills/` | | Coding | Copilot | `~/.copilot/skills/` | | Coding | Aider | `~/.aider/skills/` | | Lobster | OpenClaw (开爪) | `~/.openclaw/skills/` | | Lobster | QClaw (千爪) | `~/.qclaw/skills/` | | Lobster | EasyClaw (简爪) | `~/.easyclaw/skills/` | | Lobster | EasyClaw V2 | `~/.easyclaw-20260322-01/skills/` | | Lobster | AutoClaw | `~/.openclaw-autoclaw/skills/` | | Lobster | WorkBuddy (打工搭子) | `~/.workbuddy/skills-marketplace/skills/` | | Central | Central Skills | `~/.agents/skills/` | > Note: Claude Code also surfaces marketplace plugin directories under `~/.claude/plugins/marketplaces/*` as read-only rows in the Claude view. Those entries are display-only and are not managed like native skills in `~/.claude/skills/`. Custom platforms can be added through Settings. ## Privacy & Security - **Local-first storage** — metadata, collections, scan results, settings, and cached AI explanations stay in `~/.skillsmanage/db.sqlite` or the local skill directories you manage. - **No telemetry** — the app does not include analytics, crash reporting, or usage tracking. - **Network access is feature-driven** — outbound requests only happen when you explicitly use marketplace sync/download, GitHub import, or AI explanation generation. - **Credentials are stored locally** — GitHub PAT and AI API keys are kept in the local SQLite settings table and are not encrypted at rest by the app. - Never post real secrets in issues, pull requests, screenshots, or logs. ## Tech Stack | Layer | Technology | |-------|-----------| | Desktop framework | Tauri v2 | | Frontend | React 19, TypeScript, Tailwind CSS 4 | | UI components | shadcn/ui, Lucide icons | | State management | Zustand | | Markdown | react-markdown | | i18n | react-i18next, i18next-browser-languagedetector | | Theming | Catppuccin 4-flavor palette | | Backend | Rust (serde, sqlx, chrono, uuid) | | Database | SQLite via sqlx (WAL mode) | | Routing | react-router-dom v7 | ## Development ### Prerequisites - [Node.js](https://nodejs.org/) (LTS) - [pnpm](https://pnpm.io/) - [Rust toolchain](https://rustup.rs/) (stable) - Tauri v2 system dependencies: ### Install Dependencies ```bash pnpm install ``` ### Run in Development ```bash pnpm tauri dev ``` The Vite dev server runs on port `24200`. ### Validation ```bash pnpm test pnpm typecheck pnpm lint cd src-tauri && cargo test cd src-tauri && cargo clippy -- -D warnings ``` ## Project Structure ```text skills-manage/ ├── src/ # React frontend │ ├── components/ # UI components │ ├── i18n/ # Locale files and i18n setup │ ├── lib/ # Frontend helpers │ ├── pages/ # Route views │ ├── stores/ # Zustand stores │ ├── test/ # Vitest + RTL tests │ └── types/ # Shared TypeScript types ├── src-tauri/ # Rust backend │ └── src/ │ ├── commands/ # Tauri IPC handlers │ ├── db.rs # SQLite schema, migrations, queries │ ├── lib.rs # Tauri app setup │ └── main.rs # Desktop entry point ├── public/ # Static assets ├── CHANGELOG.md # English changelog ├── CHANGELOG.zh.md # Chinese changelog └── release-notes/ # GitHub release notes ``` ## Database The SQLite database lives at `~/.skillsmanage/db.sqlite` and is initialized automatically on first launch. ## Changelog - English: [CHANGELOG.md](https://github.com/iamzhihuix/skills-manage/blob/HEAD/CHANGELOG.md) - Chinese: [CHANGELOG.zh.md](https://github.com/iamzhihuix/skills-manage/blob/HEAD/CHANGELOG.zh.md) ## Contributing See [CONTRIBUTING.md](https://github.com/iamzhihuix/skills-manage/blob/HEAD/CONTRIBUTING.md) for development setup, validation commands, and pull request expectations. ## Community Join the Discord community: ## Security See [SECURITY.md](https://github.com/iamzhihuix/skills-manage/blob/HEAD/SECURITY.md) for vulnerability reporting and data-handling notes. ## Star History [![Star History Chart](https://api.star-history.com/svg?repos=iamzhihuix/skills-manage&type=Date)](https://www.star-history.com/#iamzhihuix/skills-manage&Date) ## License This project is licensed under the Apache License 2.0. See [LICENSE](https://github.com/iamzhihuix/skills-manage/tree/HEAD/LICENSE).