An open API service indexing awesome lists of open source software.

https://github.com/luochang212/skill-zoo

All-in-One Desktop Agent Skills Utility. Welcome to the Skill Zoo, where all your skills live!
https://github.com/luochang212/skill-zoo

ai-tools claude-code codex desktop-app rust skill-management skills tauri typescript

Last synced: 17 days ago
JSON representation

All-in-One Desktop Agent Skills Utility. Welcome to the Skill Zoo, where all your skills live!

Awesome Lists containing this project

README

          


English
简体中文

# Skill Zoo

[![Release](https://img.shields.io/github/v/release/luochang212/skill-zoo?style=flat-square&color=0e7490)](https://github.com/luochang212/skill-zoo/releases)
[![Downloads](https://img.shields.io/github/downloads/luochang212/skill-zoo/total?style=flat-square&color=0e7490)](https://github.com/luochang212/skill-zoo/releases)
[![Platform](https://img.shields.io/badge/platform-macOS%20%7C%20Windows-0e7490?style=flat-square)]()
[![License](https://img.shields.io/badge/license-MIT-0e7490?style=flat-square)](LICENSE)
[![CI](https://github.com/luochang212/skill-zoo/actions/workflows/build.yml/badge.svg)](https://github.com/luochang212/skill-zoo/actions)

![app-screenshot](docs/header-image.webp)

Local Agent Skills Manager — Discover, install, and manage skills for AI coding tools including Claude Code, Codex, Gemini, OpenCode, Cursor, Trae, Hermes, OpenClaw and more.

## 🚀 Features

- **Explore & Install**: Search and download skills from GitHub repositories
- **Update Skills**: Update installed skills to the latest version from GitHub
- **Skill Authoring**: Built-in Markdown editor — create skills anywhere, anytime
- **Batch Operations**: Install, delete, or merge duplicate skills in bulk
- **Security Audit**: View community audit scores from skills.sh
- **Consistency Check**: Proactively detect three types of inconsistencies and prompt fixes
- **Skill Archive**: Move skills into the archive as temporary storage to reduce context load
- **CLI + WUI**: Provide Skill Zoo control surfaces for Coding Agents and humans

## ✨ Tech Stack

| Layer | Technology |
|-------|-----------|
| Frontend | React 19 + TypeScript 6 + Vite 8 |
| Backend | Rust (Tauri v2) |
| Styling | Tailwind CSS 4 + shadcn/ui |
| State | TanStack React Query |
| Animation | Framer Motion |
| i18n | i18next |
| Editor | CodeMirror 6 |
| Lint | oxlint + clippy |
| Format | oxfmt + cargo fmt |
| Testing | Vitest + Rust tests |
| Package Manager | Bun |

## 📦 Installation

### macOS

Download the `.dmg` from the [Releases](https://github.com/luochang212/skill-zoo/releases) page, open it, and drag `skill-zoo.app` into `Applications`.

🧑‍💻 Install via Homebrew (macOS developers)

```bash
brew tap luochang212/tap
brew install --cask skill-zoo
```

### Windows

Download the `.exe` installer from [Releases](https://github.com/luochang212/skill-zoo/releases) and run it. The installer sets up shortcuts automatically and supports automatic updates.

> If SmartScreen shows a warning, click **"More info"** → **"Run anyway"**.

📦 Portable version (alternative)

Download the portable `.zip` from [Releases](https://github.com/luochang212/skill-zoo/releases), extract it to any folder, and run `skill-zoo.exe`. SmartScreen may also show a warning — same workaround applies.

## 🙌 CLI

When you want to manage Skill Zoo from an agent, terminal, or automation, install the npm CLI:

```bash
npm install -g skill-zoo
skill-zoo --help

skill-zoo list # List installed skills
skill-zoo doctor --fix # Diagnose and fix common issues
skill-zoo wui # Start the local Web UI
```

See: [Skill Zoo CLI](https://www.npmjs.com/package/skill-zoo)

## 📁 Project Structure

```
skill-zoo/
├── src/ # React frontend
│ ├── components/
│ │ ├── skills/ # Skill browsing, detail, install, creation
│ │ ├── settings/ # Theme, language, maintenance, about
│ │ ├── layout/ # Top navigation
│ │ └── ui/ # shadcn/ui primitives
│ ├── hooks/ # React Query hooks & cache invalidation
│ ├── i18n/ # Translations (English, Chinese)
│ ├── lib/ # Tauri API client, agent config, platform utils
│ └── types/ # TypeScript type definitions
├── src-tauri/ # Tauri + Rust backend
│ ├── src/
│ │ ├── commands/ # Tauri IPC command handlers
│ │ ├── services/ # Skill operations, CLI management, lock file
│ │ ├── persistence/ # Metadata & settings persistence
│ │ ├── config.rs # Agent config & path detection
│ │ ├── store.rs # App state
│ │ └── error.rs # Error types
│ ├── resources/ # Carousel banners, recommended repos
│ ├── Cargo.toml
│ └── tauri.conf.json
├── packages/
│ └── cli/ # npm CLI and lightweight local Web UI
│ ├── src/ # CLI commands, local protocol, WUI server
│ ├── tests/ # CLI and protocol tests
│ └── wui/ # Browser assets served by skill-zoo wui
├── docs/ # Screenshots and local protocol docs
├── fixtures/ # Desktop-owned local protocol fixtures
├── skills/ # Project automation skills
├── package.json
└── vite.config.ts
```

## 🔧 Development

Prerequisites: [Bun](https://bun.sh/), [Rust](https://www.rust-lang.org/tools/install), and a [Tauri setup](https://v2.tauri.app/start/prerequisites/).

```bash
# Install dependencies
bun install

# Run in development mode
bun run tauri dev

# Type checking
bun run typecheck

# Lint and format
bun run lint
bun run format

# Run tests
bun run test
bun run cli:test

# Rust (backend)
bun run lint:rs
bun run format:rs:check
bun run test:rs

# CLI
bun run cli:typecheck
bun run cli:build

# Build for production
bun run tauri build
```

## 😇 Trust & Security

- **Auditable Code** — 100% open source. Every build runs on GitHub Actions for anyone to inspect.
- **Connects On Demand** — No background polling. Network only fires on browse or install.
- **You Stay in Control** — Any operation that touches real files (delete, move, overwrite) asks for confirmation first.

## 💡 Contributing

Found a bug or have an idea? Open an [issue](https://github.com/luochang212/skill-zoo/issues) or submit a PR — contributions of all kinds are welcome!

## 📜 License

[MIT](LICENSE)