前言¶
在 Cursor、Claude Code 等环境里，Skill 是把领域知识、固定流程和工具调用写进 SKILL.md 的常见方式。难点往往不在「会不会写 Markdown」，而在结构是否能让 Agent 稳定触发、步骤是否可执行、更新时是否与现有约定一致。社区 Skill mj（坐标 @user_8b8494a3/mj）的定位，是面向「新建或改版 Skill」场景的编写指南，帮助把上述问题收敛到可复用的文档形态上。
这是什么¶
mj 是 SkillHub 上由社区发布者 user_8b8494a3 维护的 ai-agent 类 Skill，当前版本 1.0.0，来源标注为 community。
官方简介说明：这是一份 创建有效 Skill 的指南；当用户希望 新建 Skill，或 更新已有 Skill，以便用专门知识、工作流或工具集成扩展 Claude（及兼容 Skill 机制的 Agent）能力时，应使用本 Skill。
页面标签 requires_api_key=false，表示按 SkillHub 元数据，安装与使用不依赖额外 API Key 配置。
核心功能¶
以下能力均来自 SkillHub 页面与简介文案，未展开编造具体章节或脚本：
- Skill 编写导向：以「有效 Skill」为目标，指导如何把知识、流程、工具整合进 Skill 文档（通用
SKILL.md体系）。 - 新建与更新两类场景：明确适用于从零创建 Skill，以及对现有 Skill 做改版、增补。
- 能力扩展语境：强调 Skill 用于扩展 Agent 在专项任务上的行为，而非替代 Agent 本身的基础能力。
SkillHub 上该 Skill 的评分为 100000，下载 845 次（页面展示数据，随平台统计变化）。
安装与启用¶
SkillHub 官方建议：先阅读安装说明文档，再安装坐标 @user_8b8494a3/mj。
说明文档地址：
https://skillhub.cn/install/skillhub.md
1、安装 SkillHub CLI（若尚未安装）¶
检查是否已安装：
command -v skillhub && skillhub --version
未安装时，可按官方脚本安装（完整安装含 CLI 与默认 Skill；仅 CLI 时加 --cli-only）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
2、安装 mj 到当前 Agent 的 skills 目录¶
官方要求：安装时必须用 --dir 指向 当前 Agent 实际读取的 skills 目录，否则默认会装到 ./skills/，Agent 可能无法识别。
搜索与安装示例：
skillhub search mj
skillhub install @user_8b8494a3/mj --dir <skills 目录>
常用客户端 skills 路径（摘自 SkillHub 安装文档，按你本机环境选用其一）：
| 环境 | skills 目录 |
|---|---|
| Cursor | ~/.cursor/skills/ |
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.codex/skills/ 或项目下 .agents/skills/ |
安装完成后，按你所用客户端的说明刷新或重启 Agent，使新 Skill 被加载。
也可将下面提示交给 AI，让其按官方安装文档执行（SkillHub 页面提供的安装提示）：
请根据 https://skillhub.cn/install/skillhub.md，安装 `@user_8b8494a3/mj`。
典型用法¶
公开资料未附带完整 SKILL.md 正文，因此这里只写 可核对的触发方式，不虚构具体模板段落或命令。
- 在对话中说明目标：例如「我要为某仓库写一个新 Skill」或「我要更新现有 Skill 的安装说明与步骤」。
- 确保 Agent 已加载
@user_8b8494a3/mj（见上一节安装路径与重启要求）。 - 让 Agent 在 mj 的指南约束下产出或修改 Skill 文档：聚焦专门知识、可执行工作流、以及与工具集成的说明，并符合你目标平台对
SKILL.md的约定。
若需核对 Skill 元信息与简介，可打开 SkillHub 技能页：
https://www.skillhub.cn/skills/user_8b8494a3/mj
适用场景与注意¶
适合谁
- 需要系统化编写第一个 Skill 的开发者。
- 已有 Skill 但结构混乱、Agent 经常漏触发或误用步骤的维护者。
- 希望在 Skill 中整合领域知识与工具调用说明，而不是每次靠长提示词重复交代的人。
限制与注意
- 本 Skill 是 编写指南，不替代你对业务域、安全边界和工具权限的自行审查。
- 安装路径错误是常见坑：务必使用
skillhub install ... --dir <正确目录>。 - 页面统计（评分、下载量）以 SkillHub 实时展示为准；与第三方转载数据可能不一致。
- 未在公开页看到 API Key 要求；若你本地封装了需密钥的工具，仍须在自有 Skill 或环境中单独配置，不能假定 mj 会代管密钥。
结尾¶
mj 把「如何写出能被 Agent 稳定使用的 Skill」收敛为可安装的社区指南 Skill，适合新建与迭代 SKILL.md 时使用。安装与坐标以 SkillHub 为准：
- 技能页：https://www.skillhub.cn/skills/user_8b8494a3/mj
- API 坐标入口：https://api.skillhub.cn/user_8b8494a3/mj
