skills-manage

skills-manage is a Tauri desktop app for managing AI coding agent skills across multiple platforms from one place.

中文文档

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 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.
• 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 on local disks.
• 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

Review installed skills on a specific platform

Discover local project skill libraries

Browse marketplace publishers and skills

Import skills from a GitHub repository

Organize reusable collections

Download

• Latest release: https://github.com/iamzhihuix/skills-manage/releases/latest
• 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:

• "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:

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

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

Development

Prerequisites

• Node.js (LTS)
• pnpm
• Rust toolchain (stable)
• Tauri v2 system dependencies: https://v2.tauri.app/start/prerequisites/

Install Dependencies

pnpm install

Run in Development

pnpm tauri dev

The Vite dev server runs on port 24200.

Validation

pnpm test
pnpm typecheck
pnpm lint
cd src-tauri && cargo test
cd src-tauri && cargo clippy -- -D warnings

Project Structure

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
• Chinese: CHANGELOG.zh.md

Contributing

See CONTRIBUTING.md for development setup, validation commands, and pull request expectations.

Security

See SECURITY.md for vulnerability reporting and data-handling notes.

License

This project is licensed under the Apache License 2.0. See LICENSE.