Skip to content
Back to search

skill-base

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.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 11 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/ginuim/skill-base with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/ginuim/skill-base'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/ginuim--skill-base/badge.svg)](/listings/ginuim--skill-base)

HTML

<a href="/listings/ginuim--skill-base"><img src="/api/listings/ginuim--skill-base/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

**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"

Details: [Getting Started](docs/getting-started.md) · CLI: [docs/zh/cli.md](docs/zh/cli.md) (中文)

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 134 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. # Skill Base
  2. **English** | [中文](docs/zh/README.md)
  3. [![npm version](https://img.shields.io/npm/v/skill-base.svg)](https://www.npmjs.com/package/skill-base)
  4. [![Node version](https://img.shields.io/badge/node-%3E%3D%2018.0.0-brightgreen)](https://nodejs.org/)
  5. [![License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
  6. > 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`).
  7. <p align="center">
  8. <img src="https://github.com/ginuim/skill-base/raw/main/docs/images/demo.gif" alt="Skill Base demo" />
  9. </p>
  10. ## Why
  11. 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.
  12. 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:
  13. - **Distribution by hand** — zip files, pasted Markdown, new hires asking "where is the latest?"
  14. - **Versions by guesswork** — `final`, `final2`, `latest` everywhere; local edits untracked
  15. - **Paths by memory** — Cursor, Claude Code, Qoder, etc. use different Skill folders; install and update depend on tribal knowledge
  16. - **Access blocks PM/QA** — they need the same standards but should not need repo access or Git workflows for one Skill
  17. - **Updates stop at one machine or project** — one person fixes a Skill; other projects and teammates keep the old copy
  18. Skill Base turns Skills into **publishable, versioned, and installable** team assets.
  19. ## What it does
  20. | Capability | How |
  21. |------------|-----|
  22. | **Publish** | Web upload, `skb publish`, or GitHub import from public repos |
  23. | **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. |
  24. | **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 |
  25. | **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. |
  26. | **Desktop** | Native desktop client — [download](docs/desktop.md) |
  27. | **Visibility** | `public` / `private` skills; owner / collaborator / user permissions |
  28. <p align="center">
  29. <img src="https://github.com/ginuim/skill-base/raw/main/docs/images/desktop-market.png" alt="Skill Base desktop — Skill Market" width="720" />
  30. </p>
  31. 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.
  32. ## Quick start
  33. **Server** (Node.js >= 18):
  34. ```bash
  35. npx skill-base -d ./skill-data -p 8000
  36. ```
  37. Open the URL, complete first-time setup, create an admin account.
  38. **CLI:**
  39. ```bash
  40. npm install -g skill-base-cli
  41. skb init -s http://localhost:8000
  42. skb search vue
  43. skb install some-skill --ide cursor
  44. skb install --collection 1 --ide cursor
  45. skb install --collection frontend-team --ide cursor
  46. skb login # required for publish
  47. skb publish ./my-skill --changelog "First release"
  48. ```
  49. 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.
  50. Details: [Getting Started](docs/getting-started.md) · CLI: [docs/zh/cli.md](docs/zh/cli.md) (中文)
  51. ## Remote MCP
  52. Open **MCP & Skills** in the Web navigation for the instance URL, credential instructions, and a copyable agent setup prompt. The same page lets you download the official skills for using Skill Base with or without the CLI, or for deploying the server. Each includes a ZIP download and a copyable installation prompt.
  53. Connect an AI agent to `https://your-skill-base.example/mcp` using Streamable HTTP. Agents can search skills, browse collections, read files, compare an installed version with Head, manage favorites, and publish skills. For private skills, favorites, or publishing, configure a Skill Base personal access token in the client's `Authorization: Bearer <PAT>` header. See the [MCP setup guide](docs/zh/api.md#远程-mcp).
  54. ## Design philosophy
  55. - **Skills are the unit** — not a generic file dump or agent orchestrator.
  56. - **SQLite + ZIP on disk** — `skills.db` indexes; each release is a versioned archive. Backup = copy one directory.
  57. - **One Node process** — no Redis, MySQL, queue, or microservice mesh for a problem this size.
  58. Longer write-up: [Architecture](docs/architecture.md).
  59. ## Documentation
  60. | Doc | Contents |
  61. |-----|----------|
  62. | [Getting Started](docs/getting-started.md) | Server, CLI, first install/publish |
  63. | [Usage](docs/usage.md) | Web UI, desktop app, GitHub import, OpenClaw prompts, Skill format |
  64. | [Deployment](docs/deployment.md) | Docker, PM2, flags, sessions, backup |
  65. | [Architecture](docs/architecture.md) | Data model and stack choices |
  66. | [Desktop](docs/desktop.md) | Download and features |
  67. | [CLI](docs/zh/cli.md) | `skb` command reference (中文) |
  68. | [API](docs/zh/api.md) | HTTP API (中文) |
  69. | [Changelog](CHANGELOG.md) | Server / npm release notes |
  70. | [Author](docs/author.md) | Maintenance contract, Author's Lab |
  71. | [Docs index](docs/README.md) | Bilingual documentation map |
  72. 中文入口:[docs/zh/README.md](docs/zh/README.md)
  73. ## Author's Lab
  74. Related projects from the author.
  75. | | |
  76. |--|--|
  77. | [skillbase.reaidea.com](https://skillbase.reaidea.com) | Hosted Skill Base |
  78. | [reaidea.com](https://reaidea.com) | Author homepage and future tools |
  79. More entries land in [docs/author.md](docs/author.md) when they ship.
  80. ## Maintenance
  81. This repo is maintained by a **part-time independent developer** on evenings and weekends.
  82. Issues and PRs are welcome. There is no on-call SLA; clear, scoped PRs are easier to merge than open-ended feature asks.
  83. Full note: [docs/author.md](docs/author.md).
  84. ## License
  85. [MIT](LICENSE)
  86. ### Web visual system
  87. 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](docs/zh/design-system.md).
  88. 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.
  89. 技能详情:版本历史的更新说明支持 Markdown;文件查看支持目录树和内容区一起全屏(Esc 退出),深层目录可横向滚动,悬停显示完整路径。技能文件的 Markdown 预览中,相对链接按当前文件目录解析,并在当前版本的文件预览内打开。

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.