skillboard

A local dashboard for inspecting and managing skills across Claude Code, Codex, Cursor, and openclaw — in one place.

简体中文

What it does

• Cross-agent inventory — scans ~/.claude/skills, ~/.codex/skills, ~/.cursor/skills-cursor, ~/.openclaw/skills, plus any per-project .claude/skills/ directories you opt into.
• Spots duplicates and shadows — when the same skill name lives in multiple agents or scopes, the dashboard tells you which copy is actually loaded and where the others differ.
• Safe merge — for identical-contents conflicts, collapses copies into a single canonical source via symlinks, with full undo via the trash.
• Version history out of the box — every external edit, install, enable, disable, or manual snapshot is captured in a per-skill git repo under ~/.skillboard/versions/. Rollback in one click.

Quick start

git clone https://github.com/laylaren/skillboard.git
cd skillboard
npm install      # the `prepare` hook auto-builds the SPA bundle
npm run serve    # → ✓ skillboard dashboard at http://127.0.0.1:7300

Then open http://127.0.0.1:7300 in a browser. The CLI flag --no-open skips the auto-open behaviour, --port <n> (default 7300) lets you change the port.

Install via npm

Once published, you'll be able to run it without cloning:

npx @laylaren/skillboard

(Not on npm yet — track the issue tracker for release news.)

Supported agents

| Agent | User scope | Project / workspace scope | | ----------- | -------------------------------- | --------------------------------- | | Claude Code | ~/.claude/skills/ | <project>/.claude/skills/ | | Codex | ~/.codex/skills/ | <project>/.codex/skills/ | | Cursor | ~/.cursor/skills-cursor/ | <project>/.cursor/skills-cursor/| | openclaw | ~/.openclaw/skills/ (system) | ~/.openclaw/workspace/skills/ (workspace) |

Claude Code's plugin-bundled skills under ~/.claude/plugins/cache/.../skills/ are shown read-only — modifications belong to /plugin.

Platform support

| Platform | Status | Notes | | --- | --- | --- | | macOS | Fully supported | Primary development platform — everything tested end-to-end. | | Linux | Should work | Cross-platform code paths; not extensively tested. "Reveal in file manager" opens the parent directory rather than highlighting the file (xdg-open limitation). | | Windows | Mostly works | Most features fine, but safe-merge creates symlinks which require Administrator or Developer Mode on Windows. | | Windows + WSL2 | Recommended for Windows users | Behaves like Linux; no symlink permission issues. |

Where data is stored

All of skillboard's local state lives under ~/.skillboard/:

• ~/.skillboard/projects.json — projects you've opted into scanning
• ~/.skillboard/versions/ — per-skill bare git repos for history
• ~/.skillboard/trash/ — safety net for removed skills

There is no telemetry, no network call beyond what the browser does to 127.0.0.1, and no account.

Development

npm run web:dev    # Vite dev server with HMR (terminal 1)
npm run serve      # Fastify API (terminal 2) — proxy from the Vite server or run prod build
npm run typecheck  # tsc -b across all workspaces

The repo is an npm workspaces monorepo:

• packages/core — scanner, adapters (one per agent), versioning, file watcher
• packages/server — Fastify REST + static SPA host
• packages/web — React SPA (built artifact ships inside @skillboard/server on publish)
• packages/cli — the skillboard binary

Contributing

Issues and PRs welcome. There's no formal CONTRIBUTING.md yet; the codebase is small enough to read end-to-end in an afternoon.

License

MIT