Skip to content

ginuim/skill-base

Repository files navigation

Skill Base

English | 中文

npm version Node version License

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).

Skill Base demo

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 guessworkfinal, 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 skb install / skb update with IDE Skill paths and local install tracking
Browse Web UI for search, version switching, changelogs, tags, favorites
Desktop Native desktop client — download
Visibility public / private skills; owner / collaborator / user permissions

Skill Base desktop — Skill Market

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 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 diskskills.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

About

Private Skill distribution platform for AI coding agents: publish, install, update, and rollback team skills across Cursor, Claude Code, Codex, and OpenClaw with a minimal server + skb CLI.

Topics

Resources

Stars

Watchers

Forks

Packages

 
 
 

Contributors