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. Public skill pages also provide a version-specific npx skills add <ZIP URL> command. |
| Browse | Web UI for search, version switching, changelogs, tags, collections (max 10 skills), favorites, and skill detail pages with copyable AI Agent prompts and CLI commands for the selected version (without unnecessary quotes), collection-level AI Agent installation prompts, avatars of actual version contributors, a file reader directly below the introduction, an independent installation sidebar, and a dedicated effect preview tab without decorative cards or shadows |
| Contributions | Compact skill lists show up to three contributor avatars plus an overflow menu. Click an avatar to open /users/:id: contributed skills, published version count, and downloads of those skills, filtered by viewer access. Contributions come from version uploaders, not membership. |
| Desktop | Native desktop client — download |
| Visibility | public / private skills; owner / collaborator / user permissions |
The version diff page follows the skill detail page’s open layout, with flat version controls, underline view tabs, and scrollable code differences. The publish and account settings pages use flat sections without decorative cards. GitHub import reveals review fields after preview; branch/subdirectory options, avatar choices, and password changes expand on demand.
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 install -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"
Folder and ZIP uploads show the final file list before publishing. Web upload and skb publish use the Skill root's .gitignore by default; add project rules in .skillbaseignore, or use skb publish --ignore 'pattern'. Run skb publish --dry-run to inspect the CLI package without uploading. Agent configuration folders such as .cursor and .codebuddy are included unless explicitly ignored.
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.
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
Web visual system
The Web UI uses shared neutral buttons and form controls, light/dark themes, and a responsive two-column sign-in page. See the visual guidelines.
Skills can be downloaded as ZIP files without Node.js or skb. Public skills need no sign-in; private skills require an authorized account. The detail page includes manual import instructions and a direct-download AI prompt for the selected version.
技能详情：版本历史的更新说明支持 Markdown；文件查看支持目录树和内容区一起全屏（Esc 退出），深层目录可横向滚动，悬停显示完整路径。
