🐝 Skillbee

Personal skill manager, catalog, and deployment toolkit — for Codex / Claude / OpenCode / Gemini / Hermes / Cursor / Copilot.

English quick start: docs/README.en.md

Table of Contents

• Quick Start
• Dashboard TUI
• CLI Commands
• Architecture
• Support Matrix
• Contributing
• License

Quick Start

npm install -g skillbee
skillbee

Or without installing:

npx skillbee@latest

That's it — the Dashboard TUI opens in your terminal. Browse 56+ skills, filter by target or tag, select multiple, and install them all at once.

To install everything to all CLIs:

npx skillbee@latest bootstrap

Dashboard TUI

Press ? anytime for the full command reference.

| Key | Action | |-----|--------| | ↑ ↓ | Navigate skill list | | space | Multi-select / deselect | | i u | Install / uninstall selected to targets | | t | Open target multi-select panel | | tab | Cycle single target (within selected set) | | f | Open multi-dimension filter (status / target / tag) | | v | Toggle list / matrix overview view | | / | Search skills by name, tag, or description | | x | Archive / unarchive selected skill | | g | Toggle global / project scope | | a | Toggle archived skill visibility | | T | Cycle theme (bee / monokai / nord) | | ? | Show keyboard shortcut reference | | q | Quit |

After install/uninstall, a report overlay shows per-target × per-skill results (✓ success, ○ skipped, ✗ failed).

CLI Commands

# Open Dashboard TUI
skillbee

# Search catalog
skillbee search paper --scope project

# Install to specific target
skillbee install academic-paper-workflow --target claude --scope project

# Install to all selected targets at once
skillbee install code-guidelines --target codex --target opencode --scope global

# Full bootstrap to all CLIs
skillbee bootstrap

# Bootstrap to specific targets
skillbee bootstrap --targets codex,claude,opencode,gemini,hermes,cursor,copilot

# Dry-run (no files touched)
skillbee bootstrap --dry-run --json

# List installed skills per target
skillbee list --scope global

# Inspect a target's skill directory
skillbee inspect --target codex --scope project

# Health check
skillbee doctor --scope global

# Reset Cursor skills (clean + reinstall active)
skillbee reset --target cursor --scope all --project "$PWD" --install-all --yes

Architecture

skills/
  owned/<skill-id>/SKILL.md     # Self-authored skills (17 owned)
  archived/                      # Archived skills (hidden by default)
catalog/
  skills/*.yaml                  # External skill sources (GitHub, command)
  plugins/*.yaml                 # Plugin/extension sources
  taxonomy.yaml                  # Global tags & classification
dist/                            # Compiled CLI output
docs/
  CATALOG-CONFIG.md              # YAML catalog configuration
  README.en.md                   # English quick start

Core flow: Normalize assets from owned + catalog sources → Plan installs per target → Materialize to user-level directories (e.g., ~/.claude/skills, ~/.config/opencode/skills, ~/.gemini/extensions).

Install state is tracked via a bootstrap manifest at ~/.local/state/aimagician-skills/manifest.json. Re-running bootstrap updates existing installs without duplicating.

Support Matrix

| Capability | Status | Notes | |---|---|---| | Owned skills | ✅ | skills/owned/* synced to all targets | | GitHub skill sources | ✅ | Cloned from remote, installed per target | | Command sources | ✅ | Delegated to upstream installer | | Codex | ✅ | ~/.codex/skills | | Claude Code | ✅ | ~/.claude/skills | | OpenCode skills | ✅ | ~/.config/opencode/skills | | OpenCode plugins | ✅ | ~/.config/opencode/plugins | | Gemini extensions | ✅ | ~/.gemini/extensions | | Hermes | ✅ | ~/.hermes/skills | | Cursor | ✅ | ~/.cursor/skills | | Copilot | ✅ | ~/.copilot/skills | | Claude plugins | ⏭️ | Skipped — uses marketplace flow | | Gemini plugin catalog | ⏭️ | Skipped — extension-only |

User install paths:

| Target | Path | |--------|------| | Codex | ~/.codex/skills | | Claude | ~/.claude/skills | | OpenCode (skills) | ~/.config/opencode/skills | | OpenCode (plugins) | ~/.config/opencode/plugins | | Gemini | ~/.gemini/extensions | | Hermes | ~/.hermes/skills | | Cursor | ~/.cursor/skills | | Copilot | ~/.copilot/skills |

Bootstrap state: ~/.local/state/aimagician-skills/manifest.json (Linux) / %LOCALAPPDATA%\aimagician-skills (Windows).

Contributing

• PRs and issues welcome.
• npm run build to compile, npm test to run tests.
• README changes: sync with docs/README.en.md.

License

MIT — see LICENSE.