Skip to content

luochang212/skill-zoo

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

225 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

English 简体中文

Skill Zoo

Release Downloads Platform License CI

app-screenshot

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 page, open it, and drag skill-zoo.app into Applications.

🧑‍💻 Install via Homebrew (macOS developers)
brew tap luochang212/tap
brew install --cask skill-zoo

Windows

Download the .exe installer from 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, 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:

npm i -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

📁 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, Rust, and a Tauri setup.

# 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 or submit a PR — contributions of all kinds are welcome!

📜 License

MIT

About

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

Topics

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors