Skill Base

English | 中文

Private distribution for Agent Skills. Publish once; install, update, and roll back across Cursor, Claude Code, Codex, OpenClaw, and similar assistants — one small server, one CLI (skb).

Why

Many teams already have dozens or hundreds of Skills, but they are not team assets yet — just Markdown scattered across chat logs, personal machines, and project folders. People download from group chats, copy a colleague's old copy, or edit their local file directly. Over time, no one can say which copy is current, who changed what, or which projects still run an old version.

Some teams move Skills into Git, which helps: you get commits and a single repo. But Git answers "where do files live?", not "how does the team use them?" It does not fix fragmented Skill paths across Cursor, Claude Code, Qoder, and other agents. The real pain is distribution, install, updates, and access:

• Distribution by hand — zip files, pasted Markdown, new hires asking "where is the latest?"
• Versions by guesswork — final, final2, latest everywhere; local edits untracked
• Paths by memory — Cursor, Claude Code, Qoder, etc. use different Skill folders; install and update depend on tribal knowledge
• Access blocks PM/QA — they need the same standards but should not need repo access or Git workflows for one Skill
• Updates stop at one machine or project — one person fixes a Skill; other projects and teammates keep the old copy

Skill Base turns Skills into publishable, versioned, and installable team assets.

What it does

| Capability | How | |------------|-----| | Publish | Web upload, skb publish, or GitHub import from public repos | | Install / update / delete | skb install / skb update / skb delete with IDE Skill paths and local install tracking; skb install --collection <id-or-slug> for curated packs | | Browse | Web UI for search, version switching, changelogs, tags, collections (max 10 skills), favorites | | Desktop | Native desktop client — download | | Visibility | public / private skills; owner / collaborator / user permissions |

Quick start

Server (Node.js >= 18):

npx skill-base -d ./skill-data -p 8000

Open the URL, complete first-time setup, create an admin account.

CLI:

npm add -g skill-base-cli
skb init -s http://localhost:8000
skb search vue
skb install some-skill --ide cursor
skb install --collection 1 --ide cursor
skb install --collection frontend-team --ide cursor
skb login    # required for publish
skb publish ./my-skill --changelog "First release"

Details: Getting Started · CLI: docs/zh/cli.md (中文)

Design philosophy

• Skills are the unit — not a generic file dump or agent orchestrator.
• SQLite + ZIP on disk — skills.db indexes; each release is a versioned archive. Backup = copy one directory.
• One Node process — no Redis, MySQL, queue, or microservice mesh for a problem this size.

Longer write-up: Architecture.

Documentation

| Doc | Contents | |-----|----------| | Getting Started | Server, CLI, first install/publish | | Usage | Web UI, desktop app, GitHub import, OpenClaw prompts, Skill format | | Deployment | Docker, PM2, flags, sessions, backup | | Architecture | Data model and stack choices | | Desktop | Download and features | | CLI | skb command reference (中文) | | API | HTTP API (中文) | | Changelog | Server / npm release notes | | Author | Maintenance contract, Author's Lab | | Docs index | Bilingual documentation map |

中文入口：docs/zh/README.md

Author's Lab

Related projects from the author.

| | | |--|--| | skillbase.reaidea.com | Hosted Skill Base | | reaidea.com | Author homepage and future tools |

More entries land in docs/author.md when they ship.

Maintenance

This repo is maintained by a part-time independent developer on evenings and weekends.

Issues and PRs are welcome. There is no on-call SLA; clear, scoped PRs are easier to merge than open-ended feature asks.

Full note: docs/author.md.

License

MIT