前言¶
在 Cursor、Claude Code 等环境里写 Skill,常见卡点不是「会不会写 Markdown」,而是三件事叠在一起:不知道 SKILL.md 该长什么样、踩过的坑没人汇总、写完也不知道怎么对齐 SkillHub 发布与评测。自己翻文档往往只解决单点,缺少一条从提问、结构到发布的连贯路径。
下面介绍社区 Skill Skill 开发超级助手(坐标 @user_8c3c5215/skill-dev-super-assistant,当前版本 2.3.0)。它面向「要做出一个真实可用 Skill」的开发者,把提醒式协作、经验沉淀和发布格式收进同一套工作流。
这是什么¶
Skill 开发超级助手是 SkillHub 分类 ai-agent 下的社区 Skill(来源 community,发布者 user_8c3c5215)。页面标注作者为「听风的蚕蛹」,标签 requires_api_key=false,安装与使用不依赖额外 API Key。
一句话定位:在对话里带你从零开发可落地的 Skill,并覆盖 SkillHub 发布形态与评测优化要点(简介中写明评测目标为 4.8 分以上)。
官方入口:
- SkillHub 页面:https://www.skillhub.cn/skills/user_8c3c5215/skill-dev-super-assistant
- API 地址:https://api.skillhub.cn/user_8c3c5215/skill-dev-super-assistant
核心功能¶
以下能力均来自官方简介,安装启用后由 Skill 内指令驱动,而非独立 CLI。
提醒式回答协议¶
在给出具体答案的同时,说明开发者应如何提问、如何写指令,减少「问得太宽导致 Skill 发挥不稳定」的情况。适合边做边改 SKILL.md 时使用。
觉醒经验库¶
内置 20+ 条来自真实项目的踩坑教训,用作写 Skill 时的对照清单,避免重复犯同类结构或发布层面的错误。
SkillHub 发布标准格式模板¶
提供与 SkillHub 对齐的发布标准格式模板,便于把本地 SKILL.md 整理成可上架、可检索的形态。
评测优化指南¶
附带评测优化指引,与简介中的 4.8 分以上目标一致,用于写完初版后的迭代,而不是只停留在「能跑」。
触发词¶
在对话中可用下列表述唤起(官方列举):开发skill、写skill、skill开发、如何提问、如何给指令、提醒式回答、skill结构、避坑指南、skill开发超级助手、做个skill、新建skill、skillhub、发布skill、skill评测。
安装与启用¶
SkillHub 页面给出的方式是:让当前 AI Agent 按官方安装文档处理,并安装坐标 @user_8c3c5215/skill-dev-super-assistant。下面步骤与 https://skillhub.cn/install/skillhub.md 一致,先做 CLI,再装到当前 Agent 的 skills 目录。
1、检查 SkillHub CLI¶
command -v skillhub && skillhub --version
若未安装,可执行完整安装(CLI + 默认 Skill):
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
仅需 CLI 时:
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only
2、安装到当前 Agent 的 skills 目录¶
安装时必须用 --dir 指向当前环境的 skills 目录;否则默认落到 ./skills/,Agent 可能识别不到。常见路径示例:
- Cursor:
~/.cursor/skills/ - Claude Code:
~/.claude/skills/ - Codex:
~/.codex/skills/或项目下的.agents/skills/
将 <skills 目录> 换成你实际使用的路径后执行:
skillhub install @user_8c3c5215/skill-dev-super-assistant --dir <skills 目录>
也可先搜索再安装:
skillhub search skill-dev-super-assistant
skillhub install @user_8c3c5215/skill-dev-super-assistant --dir <skills 目录>
3、交给 Agent 的提示词(页面原文)¶
SkillHub 产品页还提供一句可直接发给 AI 的说明:
请根据 https://skillhub.cn/install/skillhub.md,安装 `@user_8c3c5215/skill-dev-super-assistant`。
安装完成后按你所用客户端要求重启或刷新 Skill 列表,再在对话里用触发词开始开发流程。
典型用法¶
官方未单独给出逐步教程截图,可复现的入口是「安装 + 触发词 + 四类能力」组合使用。建议按下面顺序在对话里推进。
- 定目标:说明你要做的 Skill 解决什么问题、运行在哪种 Agent 上。
- 唤起助手:使用触发词,例如「
skill开发帮我新建一个关于 XXX 的 skill 结构」或「skill结构+避坑指南」。 - 对齐格式:明确要求走 SkillHub 发布标准格式模板,避免后期大改 front matter 与目录结构。
- 对照经验库:在关键节点(目录划分、触发词、依赖与权限描述)让助手引用 觉醒经验库 做检查。
- 评测迭代:初版 SKILL.md 写完后,用「
skill评测」或「发布skill」引导 评测优化指南,朝简介中的高分目标收紧表述与边界。
全程保持「在学中做,在做中学」:每轮既产出片段内容,也根据 提醒式回答协议调整你下一轮的提问方式。
适用场景与注意¶
适合谁
- 第一次写 SKILL.md、需要可发布样板的开发者。
- 已在本地试错、希望系统化避坑并准备上架 SkillHub 的团队或个人。
- 希望提升 Skill 在平台评测中表现、有明确分数目标的维护者。
限制与注意
- 本文为 SkillHub 公开信息与安装文档的归纳,具体章节条文以安装后的 SKILL.md 为准;不同 Agent 对 Skill 的加载路径不同,务必用
--dir装对目录。 - 社区来源(community)意味着维护节奏取决于发布者,升级可用
skillhub在同类目录下更新,并留意版本号(当前页面为 v2.3.0)。 - 抓取资料中该 Skill 评分为 100000、下载 1093(统计会随时间变化,以 SkillHub 页面为准)。
结尾¶
Skill 开发超级助手把提醒式协作、项目级避坑、发布模板和评测指引串成一条开发路径,适合不想只靠零散文档硬啃 SKILL 格式的同行。若你正准备从 0 到 1 做一个可上架的 Skill,可从官方页安装 v2.3.0,用触发词打开对话式开发流程:https://www.skillhub.cn/skills/user_8c3c5215/skill-dev-super-assistant