0xmsc Create Skill Skill 技能

0xmsc Create Skill 是一份面向 Agent Skill 初学者的入门级写作助手。它把"如何写一个合格的 SKILL.md"拆成 frontmatter 字段、目录结构、引用资源、验证四个固定步骤，并配套提供可复用的 prompt 模板与最佳实践清单，帮助新人快速产出符合规范的 skill 文件。

核心能力

• frontmatter 字段清单：列出 SKILL.md 必须包含的字段、字段格式以及 description 撰写建议。
• 标准目录结构：展示 scripts / references / assets 三个可选目录的合理放置方式，避免空目录浪费。
• skill 创建流程：把"建目录 → 写元数据 → 补正文 → 加引用"固化成简短操作步骤。
• 格式规范引用：链接到完整的 Agent Skills 格式规范文档，便于深入查阅。
• 渐进式披露指导：提供"主文件精简、引用文件分层"的写法，让 agent 加载更高效。
• 质量自检要点：覆盖 frontmatter 完整性、描述清晰度、引用文件粒度等自检维度。
• 设计原则清单：整理出"指令先行、引用辅助、避免空目录"等可复用原则。

安装配置

• 通过 npm 安装：npx skillstore add 0xmsc/create-skill，适合本地试写 skill 时即时调用。
• 将 skills/create-skill/ 拷贝到项目 .claude/skills/ 下，供团队成员统一参考。
• 可作为 skill 教学材料嵌入 onboarding 文档或内部 Wiki。

使用步骤

1. 描述目标 skill 的用途、目标用户与典型触发语，让 agent 给出 frontmatter 草稿。
2. 在仓库中创建 /SKILL.md，按清单补齐 name、description、allowed-tools 等必填字段。
3. 按需建立 scripts/、references/、assets/ 子目录，每个目录都放真实文件，避免空目录。
4. 在 SKILL.md 正文按"指令段 / 示例段 / 参考段"分层写指令，先给最小可用版本再补充细节。
5. 用 prompt 模板"Review this SKILL.md for metadata quality..."自检 frontmatter 与正文质量。
6. 用 prompt 模板"Plan the folder structure for a skill..."规划复杂 skill 的目录结构。
7. 把 skill 的激活语、引用清单、边界条件整理成 onboarding 说明文档。

适用场景

• 第一次写 Agent Skill 的新手，需要按规范模板起步。
• 团队 onboarding 流程中给新人提供 skill 写作的速查手册。
• 把过去零散的 prompt 模板整理为标准化的 skill 文件。
• 在 PR / Code Review 中核对新人提交的 SKILL.md 是否符合基本规范。
• 作为 Agent Skills 格式规范的补充材料，在培训或分享会上使用。

适用人群

• 第一次写 Agent Skill 的产品经理、运营、独立开发者。
• 负责团队 AI 工具落地的 Tech Lead 与培训讲师。
• 维护开源 skill 仓库但希望降低贡献门槛的 Maintainer。
• 希望快速了解 Agent Skill 写作规范的技术写作者。
• 任何想尝试 Claude Code / Codex / Claude Code 自动化工作流的用户。

工作原理

skill 加载后由 Claude Code 索引器扫描 .claude/skills/create-skill/SKILL.md，把"frontmatter 字段、目录组织、引用资源、验证步骤"四个固定流程注入上下文。当用户描述想写的 skill 时，agent 会按该流程先确认目录、再写 frontmatter、再补正文、再做自检，过程中持续引用 best practices 与 anti-patterns 清单，确保最终产出符合 Agent Skills 规范的 SKILL.md 文件。

官方链接

• Skillstore 主页：https://skillstore.io/skills/0xmsc-create-skill
• GitHub 仓库：https://github.com/0xmsc/coding_assistant/tree/master/src/coding_assistant/skills/create-skill