前言¶

给 Agent 写技能包的人常遇到两类问题：一是说明写得含糊，Agent 拿到后不知道在什么条件下执行哪一步，结果是在不该用的时候频繁误触发；二是技能包只适配某一个工具，在 Cursor 里能用，换到 Claude Code 或 Codex CLI 就用不了。更常见的结果是，每个项目里都散落一份”差不多”的技能说明，改了一处忘了另一处，时间一长没人说得清哪份是最新的。

技能创建指南（@kunlungrowth/mg-skill-creator）要解决的是这件事本身：把”怎么写好一个技能包”变成一套可执行的流程，产出的包自包含、中文表述、能跨工具复用。

这是什么¶

一句话定位：这是一个”元技能”（meta-skill），指导开发者创建高质量、自包含的智能体技能包，并对中文写作场景做了适配。它本身不执行具体业务任务，而是告诉你怎么制作任务型技能。

基本信息（来自 SkillHub 页面抓取数据，抓取时间 2026-10-30）：

名称:      技能创建指南
坐标:      @kunlungrowth/mg-skill-creator
版本:      1.0.0
发布者:    昆仑增长（来源标记 enterprise）
分类:      ai-agent
评分:      100000
下载:      2113 次
安装:      0 次
标签:      requires_api_key=false
简介:      指导创建高质量、自包含的智能体技能包（中文适配）。

其中 requires_api_key=false 表示使用该 Skill 不需要额外申请 API Key，这点对只想本地跑一遍、不想先配密钥的开发者比较友好。

核心功能¶

官方简介较简短，结合通用 SKILL.md 格式，可以确认的有三点：

1、以 SKILL.md 为载体。技能包的入口是一个名为 SKILL.md 的 Markdown 文件，文件头部是 frontmatter（用 --- 包裹的元信息块），正文是分步骤的操作说明。Agent 的工作方式是先读 frontmatter 判断这个技能什么时候该用，再按正文逐步执行。

2、强调”自包含”。技能包内要自带完成任务所需的说明与命令，不依赖项目里其他文件或外部上下文补充。这是”可复用”的前提：换一个项目、换一个 Agent，技能包仍能独立工作。

3、中文适配。说明与步骤面向中文写作场景组织，产出的技能包直接用中文描述任务与判断条件，适合中文项目的 Agent 调用。

需要说明的是，官方简介未展开该 Skill 内部的章节结构，具体清单请见文末官方地址的页面。下面几节关于格式与写法的部分，属于通用 SKILL.md 规范，是这类 Skill 共用的基础，不等于该 Skill 独有的内容。

SKILL.md 的通用格式¶

frontmatter 至少要有两个字段：

---
name: my-skill
description: 当用户需要做 X 时使用此技能。适用于 A、B 场景；不适用于 C。
---

name 是技能的唯一标识，建议用小写字母、数字和连字符，与技能包目录名保持一致。description 是最关键的一段——Agent 主要靠它决定要不要加载这个技能，所以要写清适用条件与触发时机，而不是写”一个强大的工具”这类空话。

正文用 # 分节，一节只讲一件事，段落宜短。能落地的步骤用 1、2、3 或短列表；命令、路径、版本号、接口名、配置项写全，放进代码块。代码块前后用一两句说明这一步在做什么，让 Agent 知道执行的是哪个动作、产出是什么。

一个典型的技能包目录结构：

my-skill/
├── SKILL.md          # 入口说明，Agent 首先读这个
├── scripts/          # 可选，可复用的脚本
└── references/       # 可选，长篇参考文档，按需读取

正文里不要塞进大段不需要时也会被读取的内容。Agent 每次加载技能都要把 SKILL.md 整个读进来，正文越长、无关信息越多，判断就越容易失准。长内容可以放进 references 目录，正文里写一句”详细参数见 references/xxx.md，需要时再读”。

安装与启用¶

本次未能从官方页面核实到安装命令（SkillHub 页面与 API 地址均抓取失败），因此不在此给出未经验证的命令。可用的核实信息如下：

SkillHub 页面: https://www.skillhub.cn/skills/kunlungrowth/mg-skill-creator
官方地址:     https://api.skillhub.cn/kunlungrowth/mg-skill-creator
坐标:         @kunlungrowth/mg-skill-creator

建议先打开上面第一个地址，查看页面给出的安装方式与支持的工具列表。Cursor、Codex CLI、Claude Code 的接入方式如有差异，页面通常会分别说明；核实不到的环节不要照搬网上的其他 Skill 教程。

典型用法¶

官方资料未提供可复现的示例任务。技能创建的一般流程如下：

1、先定义边界。写下这个技能解决什么问题、输入是什么、产出是什么，以及明确的不适用场景。描述写得越具体，Agent 越不容易误触发。可以先问自己一句：”用户在什么情况下会需要它？”如果这句话答不上来，说明边界还没想清。

2、再写 SKILL.md。frontmatter 里给 name 和 description，description 中写清适用条件与触发时机；正文按 1、2、3 组织步骤，命令、路径、配置项写全，放进代码块。每个步骤的产出要明确，下一个步骤才能正确接续。

3、最后做一次真实验证。把技能放进项目，用一个真实任务跑一遍，检查 Agent 是否按步骤执行、是否在不适用的场景下误触发。发现问题就回头改描述和步骤，而不是改任务迁就技能。验证至少覆盖两个用例：一个是该触发的，一个不该触发的——后者往往更重要。

常见错误¶

下面几条来自编写技能包的通用经验，供自查：

1、description 写成营销语。”赋能”“颠覆”“非常强大”这类词对 Agent 判断没有帮助，它需要的是具体条件。

2、步骤里出现”适当”“按需”这类模糊词，却没有给出判断标准。要么写明判断依据，要么拆成更细的步骤。

3、把所有上下文都塞进 SKILL.md，导致每次加载都读入大量无关内容。长内容应该拆到 references 里按需读取。

4、技能包依赖项目里的其他文件，但没有在说明里写清依赖关系。一旦换项目，技能包就会静默失败。

适用场景与注意¶

适合谁：需要在多个项目里给 Agent 沉淀可复用流程的开发者；希望技能包不绑定单一工具、能用通用 SKILL.md 格式维护的人；以及正在给 Agent 写第一版技能包、想要一份规范化检查清单的人。

注意三点：

1、这是一份”创建指引”，最终质量取决于你按指引写出的 SKILL.md，Skill 本身不会替你生成技能内容。把它当成审查清单用，比当成生成器用更实际。

2、页面显示安装数为 0，说明当前使用人数还很少，生态反馈有限。建议先在小范围任务上验证产出，再推广到团队。

3、评分与下载量为抓取时（2026-10-30）的页面数据，后续可能变化，引用时以页面实时数据为准。

结尾¶

技能创建指南的价值在于把技能包的写法规范化：边界清晰、步骤可执行、包体自包含、中文可直接使用。如果你正在给 Agent 写第一版技能包，或者想把散在各项目里的说明收敛成标准格式，可以从它入手。

官方地址：https://api.skillhub.cn/kunlungrowth/mg-skill-creator
SkillHub 页面：https://www.skillhub.cn/skills/kunlungrowth/mg-skill-creator