skill-man

████ █  █ ███ █    ▓      ▓   ▒  ▒▒  ▒  ▒
█    █ █   █  ▓    ▓      ▓▓ ▒▒ ▒  ▒ ▒▒ ▒
███  ██    █  ▓    ▓      ▓ ▒ ▒ ▒▒▒▒ ▒ ▒▒
   █ █ █   █  ▓    ▓      ▓   ▒ ▒  ▒ ▒  ▒
████ █  █ █▓▓ ▓▓▓▓ ▓▓▓▓   ▒   ▒ ▒  ▒ ▒  ░

npm install -g @joehe0x/skill-man && cd your-project && skill-man

Why skill-man?

You use more than one AI coding agent. Each one hides Skills and MCP servers in different folders (mcp.json, config.toml, .claude.json, …). You grep, edit blind, rescan mentally, and still wonder which tool actually picked up the change.

skill-man is a keyboard-first terminal workbench — split list + live preview, mutations on real files on disk:

How is this different?

Who is it for? Developers who daily-switch between Cursor, Claude Code, Codex, or Windsurf and want one place to manage skills and MCP without leaving the terminal.

skill-man puts everything in one split-pane UI:

Built with Charm — Bubble Tea, Lip Gloss, Glamour.

Features

Skills tab

• Scan project & global skill dirs across 70+ agent layout conventions
• List / find / filter by agent
• Live preview of SKILL.md (Markdown)
• Inspect skill file trees · install · init templates · update
• Bind / unbind to agents (symlinks) · enable / disable · remove (confirmed)

MCP tab

• Discover real MCP entries from JSON & TOML (not a placeholder list)
• Skills ↔ MCP via Tab / Shift+Tab
• Preview stdio vs URL transport and raw config
• Toggle enable/disable · bind into another agent’s config · remove (confirmed)

UX

• Split list + preview (stacks on narrow terminals)
• Branded header: ASCII logo + live overview in a bordered banner
• Status bar: scope, agents, skill/MCP counts, readiness
• Mouse-friendly scrolling where supported

Quick start

Requirements

• Node.js 18+ (recommended) or Go 1.26+ (from source / fallback)
• True-color terminal recommended (iTerm2, WezTerm, Kitty, Windows Terminal, …)

Install

npm (recommended — no Go toolchain required):

npm install -g @joehe0x/skill-man
# or from this repo before publish:
npm install -g .

Installs a prebuilt binary from GitHub Releases. If the asset is not published yet, the installer builds from local source (when installing from a clone) or falls back to go install when Go is on your PATH.

Maintainers: push tag v* to trigger GoReleaser, then npm publish from the repo root.

From GitHub (Go):

go install github.com/JoeHe0x/skill-man/cmd/skill-man@v0.1.0

From source:

git clone https://github.com/JoeHe0x/skill-man.git
cd skill-man
make install   # → $GOPATH/bin/skill-man

Or run without installing:

make dev       # go run ./cmd/skill-man

Run

cd your-project
skill-man

Uses your current working directory as the project root and scans project + user-level configs.

Re-record demo

To refresh docs/demo.gif (Enter · X · MCP tab — short tape, see docs/demo/demo.tape):

go install github.com/charmbracelet/vhs@latest
brew install ffmpeg ttyd
make demo

See docs/demo/README.md.

Keybindings

MCP config discovery

Bind merges a server into the target agent config. Toggle and remove edit the underlying JSON/TOML in place.

Skills compatibility

Aligned with the vercel-labs/skills model:

• Standard SKILL.md layout · project vs global scope
• Agent-specific install directories · install / update / remove flows

Documentation

• TUI 现代化改造路线图 — Bubble Tea 示例对照、分阶段计划与完成状态
• GitHub 发现性设置 — About、Topics、Social preview（维护者）
• 推广短文大纲 — 中英帖模板与投放顺序

Architecture

cmd/skill-man          CLI entry
internal/app           Bubble Tea UI (panels, keys, layout)
  └── panel/           Skills & MCP tab strategies
internal/usecase       Use cases (no UI deps)
  ├── extension/       Remove, disable, add, init, update
  └── bind/            Agent bind/unbind for skills and MCP
internal/domain        Skill, MCP, Agent, Extension
internal/service
  ├── skill/           Scan, install, preview, update
  ├── mcp/             Scan, parse (JSON/TOML), mutate
  └── manager/         Generic extension scanner

Development

npm package (from repo):

npm install -g .   # postinstall builds ./cmd/skill-man into dist/

Go:

make test          # unit tests (+ race in CI)
make test-cover    # coverage
make fmt vet       # format & vet
make lint          # golangci-lint (optional)

Roadmap

• Publish module path github.com/JoeHe0x/skill-man
• Tag v0.1.0 on GitHub
• Demo GIF in README
• CI (test + vet on PR)
• golangci-lint in CI (optional)
• npm package (npm install -g @joehe0x/skill-man)
• Publish to npm registry on tag
• Homebrew formula (optional)
• Hooks / sub-agent tabs

Want a feature? Open an issue or send a PR — see Contributing.

Contributing

1. Fork JoeHe0x/skill-man
2. Branch: git checkout -b feat/your-idea
3. make test — keep PRs focused
4. Open a pull request

License

MIT © JoeHe0x

中文简介

skill-man 是用 Go + Bubble Tea 打造的终端工作台：一个界面管理 Agent Skills 和 MCP，不用在十几个路径里 find、手改 JSON。

和别的工具差在哪？

为什么值得 Star？

• 左侧列表、右侧实时预览 SKILL.md / MCP 配置
• Skills / MCP 双 Tab，Tab 切换，Ctrl+R 一键重扫
• 绑定、启用/禁用、删除（带确认），改的是真实配置文件
• Cursor、Claude Code、Codex、Windsurf 等常见路径

快速开始：

npm install -g @joehe0x/skill-man
# 或 Go：go install github.com/JoeHe0x/skill-man/cmd/skill-man@v0.1.0
# 或源码：git clone ... && make install
cd 你的项目目录 && skill-man

觉得有用的话，欢迎 点 Star ⭐，让更多人发现这个项目。

⭐ Star skill-man · Report issue · _{Built with Charm · Happy shipping}