SkillBase
登录
使用帮助

SkillBase使用指南

从注册到精通,几分钟学会用SkillBase管理你的个人Skill仓库和团队空间。

01 -

注册与登录

访问SkillBase首页,点击右上角「登录」,选择「立即注册」。填写用户名、邮箱和密码即可创建账号。

注册后,进入「设置 → API Token」页面创建一个Token,后续CLI登录需要用到。

个人使用完全免费,50MB存储空间,够存几百个Skill。

02 -

安装CLI工具

打开终端(Mac的Terminal、Windows的PowerShell),执行以下命令:

  • npm i -g skillbasecn —— 全局安装SkillBase命令行工具,只需执行一次。
  • 安装后会自动检测你电脑上的AI终端(Claude Code、Cursor、Codex、Trae等20+终端)。
03 -

CLI登录

安装CLI后,用你的API Token登录:

  • skillbase login --token 你的Token
  • Token在网站「设置 → API Token」页面创建和复制。
  • 登录后账号与这台电脑绑定,后续所有命令自动使用该身份。
04 -

创建你的第一个Skill

一个Skill的核心是一个SKILL.md文件,格式如下:

  • --- 之间的部分是元信息(YAML frontmatter):name(Skill名称)、description(一句话描述)为必填;version(版本号)可选,不填则默认为v年月日.时分秒,如v20260801.093501。
  • --- 下面是Skill的正文,Markdown格式,写你希望AI看到的指令和说明。
  • 在正文中用 [[其他skill名]] 可以创建双向链接,发布后自动在Skill图谱中连线。
05 -

上传Skill

两种方式,任选其一:

  • 网页上传:进入「我的仓库」→ 点击「上传Skill」→ 选择SKILL.md文件或zip包 → 设置分类、标签、可见性 → 点击发布。
  • CLI上传:skillbase publish ./你的Skill文件夹,自动打包上传。可用 --dry-run 先校验不发布。
  • 上传后自动进入安全扫描,扫描通过即可使用。
06 -

管理你的个人仓库

「我的仓库」是你所有个人Skill的管理中心:

  • 分类(文件夹):新建、重命名、删除、拖拽排序。一个Skill只属于一个分类。每个分类有英文slug,CLI命令用slug引用。
  • 标签:一个Skill可以有多个自定义标签,用于跨分类筛选。
  • 可见性:公开(所有人可见可下载)或私有(仅自己可见)。团队Skill上传时自动锁定为"仅团队成员可见"。
  • 版本管理:每次上传生成新版本。详情页可查看版本历史、对比版本差异。
  • 存储空间:个人免费50MB。Skill通常是KB级,50MB能存几百个。标题右侧实时显示用量。
  • 删除Skill:支持硬删除(彻底清除)和归档(暂时隐藏,可恢复)。
07 -

个人常用CLI命令

以下为日常使用频率最高的命令(完整19条命令见CLI技术文档):

命令说明
skillbase search [关键词]搜索你的个人Skill仓库,不传关键词显示全部
skillbase search --folder <slug>按分类搜索
skillbase install @用户名/Skill名安装指定Skill到所有AI终端
skillbase sync一键同步云端已发布Skill到本地
skillbase sync --folder <slug>只同步某个分类
skillbase install-folder <slug>批量安装某个分类下所有已发布Skill
skillbase install-published批量安装所有已发布Skill
skillbase list查看本地已安装的Skill列表
skillbase outdated检查哪些Skill有新版本
skillbase skill-update一键升级所有Skill到最新版
skillbase skill-update @用户名/Skill名升级指定Skill
skillbase remove <Skill名>删除本地已安装的Skill
skillbase doctor扫描项目目录,合并到本地Skill清单
skillbase update更新SkillBase CLI自身
08 -

Skill图谱(双向链接)

在SKILL.md正文中用 [[skill-slug]] 引用其他Skill,上传时自动解析并创建双向链接。例如:

这个流程用到了 [[mcp-builder]] 和 [[canvas-design]] 。

进入「Skill图谱」页面(/dashboard/graph),可以看到所有Skill的关系网络可视化。支持拖拽、缩放、悬停高亮关联Skill、按分类或标签着色。

这是目前所有Skill平台都没有的能力——文件夹给结构,标签给属性,双向链接给关系。

09 -

安装Skill到AI终端

在任意Skill详情页,有三种安装方式:

  • CLI一行命令:npx skillbasecn install @用户名/Skill名 。公开Skill无需登录,私有或团队Skill需先skillbase login。
  • URL+MD自动读取:把安装指南URL发给AI终端(如Claude Code),AI自动读取并安装。私有和团队Skill隐藏此选项。
  • 直接下载zip:不需要CLI,下载解压到Skill目录即可。
10 -

团队空间(Team会员)

团队空间让多人共享同一个Skill库。Team会员¥19.80/季,可创建最多3个团队、每团≤20人、共享100MB存储池。

  • 创建团队:进入「我的团队」→ 点击「新建团队」→ 填写团队名称、标识和加入密码(至少6位,含字母和数字)。
  • 成员加入:Owner分享团队链接+加入密码,成员在团队页面输入密码即可加入。
  • 三级角色:Owner(创建者,最高权限)、Admin(管理员,可管理成员和上传Skill)、Member(普通成员,只读使用)。
  • 团队上传:只有Owner和Admin可以上传Skill到团队。上传时可见性自动锁定为"仅团队成员可见",不可更改。
  • 团队Skill卡片:显示上传者、团队说明(可点击修改)、安装命令。支持更新和删除(需Owner/Admin权限)。
  • 成员管理:Owner/Admin可在团队设置中修改成员角色或移除成员。不能修改自己的角色。
  • 存储池:团队存储池与个人50MB独立计算,互不影响。
11 -

团队CLI命令

团队成员通过CLI批量安装和搜索团队Skill:

命令说明
skillbase team-pull <团队标识>一键安装该团队全部可见Skill(新人入职必备)
skillbase team-pull <团队标识> --department <slug>只装指定部门的Skill(Pro专属)
skillbase team-pull <团队标识> --common只装公共区Skill(Pro专属)
skillbase team-search <团队标识> [关键词]搜索团队Skill库
skillbase outdated检查本地所有Skill的更新(含团队Skill)
skillbase skill-update一键升级所有Skill(含团队Skill)
12 -

部门隔离(Team Pro会员)

Team Pro¥29.70/季,可创建最多3个团队、每团≤100人、共享200MB存储池。核心卖点是部门隔离:

  • 启用部门:Pro团队Owner在设置中开启部门隔离 → 创建部门(如"研发部""设计部",最多10个)→ 将成员分配到各部门。
  • Skill可见范围:成员上传Skill时指定部门,该Skill仅本部门成员可见。公共区Skill全员可见。
  • 部门间互不可见:研发部看不到设计部的Skill,反之亦然。数据严格隔离。
  • OWNER/ADMIN统管全部:可查看所有部门Skill,普通成员仅限本部门+公共区。
  • 降级后:会员到期降为免费档后,部门隔离可见性照常生效(只读),但不可新增/修改部门。
13 -

会员订阅与激活

个人永久免费。付费=团队功能。激活码是唯一的会员开通方式:

  • 获取激活码:通过爱发电(afdian.com/a/skillbase)购买,或参与推广活动获取。
  • 兑换激活码:进入「设置 → 会员激活」→ 输入激活码 → 点击激活。激活后立即获得对应档位的会员资格。
  • 会员有效期:每码90天。多个激活码可叠加,时长自动累加(新到期 = 当前到期 + 90天)。
  • 到期处理:到期前7天发送邮件提醒。到期当天自动降为免费档,团队变为只读(仍可浏览和安装Skill,但不可上传和管理成员)。
  • 查看状态:进入「我的团队」页面,状态栏显示当前档位、到期时间和团队用量。
14 -

安全扫描

每个Skill上传后自动安全扫描,三级分类:

  • 🟢 安全:正常发布,可设公开或私有。
  • 🟡 有风险:可发布但强制私有(检测到prompt注入、敏感指令等)。
  • 🔴 危险:直接阻止发布并删除(严重风险,如绕过安全指令、窃取数据等)。
  • 扫描基于42条正则规则+10个YARA规则+内置RED FLAG检测,覆盖8类风险。全自动,不涉及人工审核。被误判可修改内容后重新上传。
15 -

跟AI说话就能管理

安装CLI后,skillbase-manager会自动装到你的AI终端。你可以用自然语言操作:

  • "搜索PPT相关的Skill" → AI自动执行skillbase search PPT
  • "安装canvas-design" → AI自动执行skillbase install @用户名/canvas-design
  • "拉取我们团队的Skill" → AI自动执行skillbase team-pull 团队标识
  • "检查有哪些Skill需要更新" → AI自动执行skillbase outdated
  • "更新所有Skill" → AI自动执行skillbase skill-update
16 -

常见问题

  • 支持哪些AI终端?Claude Code、Cursor、Codex、GitHub Copilot、Gemini CLI、Trae、CodeBuddy、WorkBuddy、Qoder、Windsurf等20+主流终端。
  • 我的Skill安全吗?每个上传都过安全扫描。私有Skill别人完全看不到。团队Skill非团队成员也看不到。
  • 收费吗?个人使用永久免费(50MB存储)。付费=团队功能(Team¥19.80/季、Team Pro¥29.70/季)。
  • 换电脑了怎么办?重装CLI(npm i -g skillbasecn)→ skillbase login,Skill全在云端不会丢。
  • Token在哪里获取?登录网站 → 设置 → API Token → 创建。
  • 怎么更新CLI?skillbase update,自动从npm拉最新版。
  • 上传的Skill能删吗?可以。在Skill卡片上点删除。删除后相关文件、版本、扫描记录全部清理。
  • 团队Skill能设公开吗?不能。团队Skill强制"仅团队成员可见",不可改为公开或私有。
  • 会员到期后团队Skill还在吗?还在,团队成员仍可浏览和安装。但不能上传新Skill、管理成员或修改设置。
  • 激活码可以转让吗?不能。兑换后即与账号绑定。