SkillBase使用指南
从注册到精通,几分钟学会用SkillBase管理你的个人Skill仓库和团队空间。
注册与登录
访问SkillBase首页,点击右上角「登录」,选择「立即注册」。填写用户名、邮箱和密码即可创建账号。
注册后,进入「设置 → API Token」页面创建一个Token,后续CLI登录需要用到。
个人使用完全免费,50MB存储空间,够存几百个Skill。
安装CLI工具
打开终端(Mac的Terminal、Windows的PowerShell),执行以下命令:
- npm i -g skillbasecn —— 全局安装SkillBase命令行工具,只需执行一次。
- 安装后会自动检测你电脑上的AI终端(Claude Code、Cursor、Codex、Trae等20+终端)。
CLI登录
安装CLI后,用你的API Token登录:
- skillbase login --token 你的Token
- Token在网站「设置 → API Token」页面创建和复制。
- 登录后账号与这台电脑绑定,后续所有命令自动使用该身份。
创建你的第一个Skill
一个Skill的核心是一个SKILL.md文件,格式如下:
- --- 之间的部分是元信息(YAML frontmatter):name(Skill名称)、description(一句话描述)为必填;version(版本号)可选,不填则默认为v年月日.时分秒,如v20260801.093501。
- --- 下面是Skill的正文,Markdown格式,写你希望AI看到的指令和说明。
- 在正文中用 [[其他skill名]] 可以创建双向链接,发布后自动在Skill图谱中连线。
上传Skill
两种方式,任选其一:
- 网页上传:进入「我的仓库」→ 点击「上传Skill」→ 选择SKILL.md文件或zip包 → 设置分类、标签、可见性 → 点击发布。
- CLI上传:skillbase publish ./你的Skill文件夹,自动打包上传。可用 --dry-run 先校验不发布。
- 上传后自动进入安全扫描,扫描通过即可使用。
管理你的个人仓库
「我的仓库」是你所有个人Skill的管理中心:
- 分类(文件夹):新建、重命名、删除、拖拽排序。一个Skill只属于一个分类。每个分类有英文slug,CLI命令用slug引用。
- 标签:一个Skill可以有多个自定义标签,用于跨分类筛选。
- 可见性:公开(所有人可见可下载)或私有(仅自己可见)。团队Skill上传时自动锁定为"仅团队成员可见"。
- 版本管理:每次上传生成新版本。详情页可查看版本历史、对比版本差异。
- 存储空间:个人免费50MB。Skill通常是KB级,50MB能存几百个。标题右侧实时显示用量。
- 删除Skill:支持硬删除(彻底清除)和归档(暂时隐藏,可恢复)。
个人常用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自身 |
Skill图谱(双向链接)
在SKILL.md正文中用 [[skill-slug]] 引用其他Skill,上传时自动解析并创建双向链接。例如:
这个流程用到了 [[mcp-builder]] 和 [[canvas-design]] 。
进入「Skill图谱」页面(/dashboard/graph),可以看到所有Skill的关系网络可视化。支持拖拽、缩放、悬停高亮关联Skill、按分类或标签着色。
这是目前所有Skill平台都没有的能力——文件夹给结构,标签给属性,双向链接给关系。
安装Skill到AI终端
在任意Skill详情页,有三种安装方式:
- CLI一行命令:npx skillbasecn install @用户名/Skill名 。公开Skill无需登录,私有或团队Skill需先skillbase login。
- URL+MD自动读取:把安装指南URL发给AI终端(如Claude Code),AI自动读取并安装。私有和团队Skill隐藏此选项。
- 直接下载zip:不需要CLI,下载解压到Skill目录即可。
团队空间(Team会员)
团队空间让多人共享同一个Skill库。Team会员¥19.80/季,可创建最多3个团队、每团≤20人、共享100MB存储池。
- 创建团队:进入「我的团队」→ 点击「新建团队」→ 填写团队名称、标识和加入密码(至少6位,含字母和数字)。
- 成员加入:Owner分享团队链接+加入密码,成员在团队页面输入密码即可加入。
- 三级角色:Owner(创建者,最高权限)、Admin(管理员,可管理成员和上传Skill)、Member(普通成员,只读使用)。
- 团队上传:只有Owner和Admin可以上传Skill到团队。上传时可见性自动锁定为"仅团队成员可见",不可更改。
- 团队Skill卡片:显示上传者、团队说明(可点击修改)、安装命令。支持更新和删除(需Owner/Admin权限)。
- 成员管理:Owner/Admin可在团队设置中修改成员角色或移除成员。不能修改自己的角色。
- 存储池:团队存储池与个人50MB独立计算,互不影响。
团队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) |
部门隔离(Team Pro会员)
Team Pro¥29.70/季,可创建最多3个团队、每团≤100人、共享200MB存储池。核心卖点是部门隔离:
- 启用部门:Pro团队Owner在设置中开启部门隔离 → 创建部门(如"研发部""设计部",最多10个)→ 将成员分配到各部门。
- Skill可见范围:成员上传Skill时指定部门,该Skill仅本部门成员可见。公共区Skill全员可见。
- 部门间互不可见:研发部看不到设计部的Skill,反之亦然。数据严格隔离。
- OWNER/ADMIN统管全部:可查看所有部门Skill,普通成员仅限本部门+公共区。
- 降级后:会员到期降为免费档后,部门隔离可见性照常生效(只读),但不可新增/修改部门。
会员订阅与激活
个人永久免费。付费=团队功能。激活码是唯一的会员开通方式:
- 获取激活码:通过爱发电(afdian.com/a/skillbase)购买,或参与推广活动获取。
- 兑换激活码:进入「设置 → 会员激活」→ 输入激活码 → 点击激活。激活后立即获得对应档位的会员资格。
- 会员有效期:每码90天。多个激活码可叠加,时长自动累加(新到期 = 当前到期 + 90天)。
- 到期处理:到期前7天发送邮件提醒。到期当天自动降为免费档,团队变为只读(仍可浏览和安装Skill,但不可上传和管理成员)。
- 查看状态:进入「我的团队」页面,状态栏显示当前档位、到期时间和团队用量。
安全扫描
每个Skill上传后自动安全扫描,三级分类:
- 🟢 安全:正常发布,可设公开或私有。
- 🟡 有风险:可发布但强制私有(检测到prompt注入、敏感指令等)。
- 🔴 危险:直接阻止发布并删除(严重风险,如绕过安全指令、窃取数据等)。
- 扫描基于42条正则规则+10个YARA规则+内置RED FLAG检测,覆盖8类风险。全自动,不涉及人工审核。被误判可修改内容后重新上传。
跟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
常见问题
- 支持哪些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、管理成员或修改设置。
- 激活码可以转让吗?不能。兑换后即与账号绑定。