Skip to content

zzjzz9266a/skillhub

Repository files navigation

SkillHub

A native macOS app for managing AI coding agent skills across multiple agents.

macOS 14+ Swift 5.9 License MIT

English | 中文

SkillHub screenshot

What is this

AI coding agents like Claude Code, Codex, and OpenCode support "skills" — Markdown files dropped into a config directory that give the agent extra context, instructions, or domain knowledge. Managing these across multiple agents and multiple skill sources quickly becomes painful: which skills are enabled for which agent? How do you enable a whole source at once?

SkillHub gives you a single window to see and control all of it.

Features

  • Skill Matrix — one row per skill, one column per agent; toggle any cell with a switch
  • Batch toggle — click a source or group pill to enable/disable all its skills for an agent at once
  • Multi-source — install from a Git URL or a local folder; multiple sources coexist
  • Auto-detect agents — detects installed agents by checking their config paths; uninstalled agents appear dimmed
  • Live sync — writes directly to each agent's config file on toggle; no separate "save" step
  • Search — filter skills by name across all sources (⌘F)
  • Git update — pull the latest skills from a Git-based source with one click

Supported agents

Agent Config path
Claude Code ~/.claude/
Gemini CLI ~/.gemini/
Codex ~/.codex/
OpenCode ~/.config/opencode/
Trae CN ~/.trae-cn/
OpenClaw ~/.openclaw/
Hermes ~/.hermes/

Requirements

  • macOS 14 Sonoma or later
  • Xcode 15+ or Swift 5.9+ (to build from source)

Build & run

git clone https://github.com/zzjzz9266a/skillhub.git
cd skillhub
swift run

Or open in Xcode:

open Package.swift

Install a skill source

  1. Click + in the toolbar
  2. Paste a Git URL (e.g. https://github.com/someone/skills) or a local path
  3. SkillHub clones/copies the source and shows all discovered skills in the matrix
  4. Toggle individual skills or use the source-level pill to enable everything at once

How skills work

A skill is a Markdown file (.md) inside a source directory. SkillHub reads the YAML front matter for metadata (name, description) and writes to each agent's config to register or deregister the skill.

my-skills/
├── code-review.md       # a skill
├── web-design.md        # another skill
└── tools/
    └── sql-helper.md    # grouped under "tools"

Roadmap

v1.x — Polish

  • Custom folders within a source — drag skills into your own groupings without touching the source repo
  • Skill detail panel — description, file path, enabled-by summary in one popover
  • Update notifications — badge when a Git source has new commits upstream
  • Full-text search — search skill descriptions and tags, not just names

v2 — Expand

  • More agents — Cursor, Aider, Continue.dev, Cline
  • Skill Profiles — save a named set of toggles ("Web mode", "Data mode") and switch between them in one click
  • iCloud sync — share toggle state across multiple Macs

v3 — Ecosystem

  • Skill browser — search and install public skill repos from GitHub without leaving the app
  • CLI companion — skillhub enable <skill> --agent claude for terminal workflows

Have an idea? Open an issue.

Tech stack

  • SwiftUI + AppKit — native macOS UI, NSVisualEffectView for sidebar vibrancy
  • GRDB — SQLite via GRDB.swift for local state
  • Yams — YAML parsing via Yams for skill front matter
  • Swift Package Manager — no Xcode project file required

License

MIT

About

A native macOS app for managing AI coding agent skills across multiple agents

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages