1. 基本信息
| 项目 | 内容 | 数据来源 |
|---|---|---|
| 名称 | skill-creator（正式名称：skill-creator-microsoft-skills） | — |
| 作者/维护者 | Microsoft（microsoft/skills 官方仓库；该子技能主要由 Larry Osterman 等多位工程师持续维护） |
GitHub API |
| 来源链接 | https://github.com/microsoft/skills/tree/main/.github/skills/skill-creator | — |
| 许可证 | MIT（仓库根目录 LICENSE 文件） | GitHub API |
| GitHub Stars / Forks | 所属合集仓库 2,818★ / 317 forks（该数字属整个合集仓库，不代表本技能自身热度，仅供了解所属仓库规模） | GitHub API |
| 最新版本 | 无独立版本号，随仓库滚动更新；本子目录最近一次实质更新在 2026-07-16（新增生命周期指引与 Azure SDK 模式参考文档） | GitHub API（commits） |
| 安装方式 | npx skills add microsoft/skills 交互式向导勾选该技能；或手动 clone 仓库后复制/软链接 .github/skills/skill-creator 到目标 agent 的技能目录 |
仓库 README |
2. 功能介绍与亮点
skill-creator 是一份专门指导 AI 编码 agent 为 Azure SDK 与 Microsoft Foundry 服务编写高质量 skill 的方法论文档，核心提出四条编写原则：简洁至上（每段内容都要证明其 token 成本合理）、新鲜文档优先（Azure SDK 频繁变动，指示 agent 在实现前查询官方文档验证当前 API 签名，而非依赖训练记忆）、自由度分级（按实现约束的严格程度，在文字指引、伪代码、精确脚本三种表达方式间取舍）、渐进式披露（元数据约 100 词常驻上下文、SKILL.md 正文控制在 500 行内、详细参考按需加载）。
配套三个本地脚手架脚本：init_skill.py（从模板初始化新技能骨架）、package_skill.py（打包为可分发的 .skill 文件）、quick_validate.py（校验 YAML frontmatter 是否合规），以及覆盖 Python / .NET / Java / Rust / TypeScript 五种语言 SDK 模式的参考文档。
亮点：官方仓库出品，近 5 个月内至少 4 位不同工程师（Larry Osterman、samvaity、arimu1 等）持续提交改进；仓库自带 Evals & Tests、Copilot SDK Tests 两条 CI 工作流对技能库做自动化回归测试。
3. 适用场景
固定分类：元技能与 Agent 增强
主要面向需要为 Azure SDK 或 Microsoft Foundry 服务编写 agent skill 的开发者与技能维护团队；其“渐进式披露”“自由度分级”等编写原则具有通用参考价值，也适合任何想系统学习 skill 编写方法论的初中级用户。
4. 跨 Agent 兼容性
- Claude Code：✅ 原生支持——仓库 README 手动安装示例明确给出
ln -s .../.github/skills /path/to/project/.claude/skills软链接方法 - Codex：❓ 未验证——仓库含通用
Agents.md编码规范文件，但未见针对本技能的 Codex 专属安装说明 - OpenClaw：❓ 未验证——README 提及的
.opencode/skills软链接对象是 OpenCode，与 OpenClaw 是不同项目，不能等同视为兼容证据 - Hermes Agent：❓ 未验证——未见相关材料
5. 推荐理由
官方多位工程师持续维护的 Azure/Foundry 专精 skill 编写方法论，附带可直接使用的脚手架脚本，填补了“如何写好一个 SDK/API 类 skill”这一此前未被覆盖的细分场景。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 7 | 合集仓库整体规模不计入个体评分；该子技能自身近 5 个月内有至少 4 位不同工程师提交 PR 持续迭代，属子目录级别的活跃协作证据 |
| 可用性 | 9 | npx skills add 一条命令交互安装；文档完整（主文档 + 3 份参考文档 + 3 个脚手架脚本），最近一次实质更新距今 10 天，无付费依赖 |
| 安全性 | 9 | 三个脚本全文核查均为纯本地文件操作，无网络请求、无 shell 外部命令；SKILL.md 正文反而明确警示“硬编码 api_key 是安全风险”；官方仓库多位具名工程师维护；MIT 许可证明确 |
| 综合 | 8.3 | 三项均值 |
安全检查清单逐项结果：① 无 shell 命令执行，脚本仅做本地文件读写与打包 ② 不联网外发任何数据 ③ 技能本身不要求任何 API key 或凭据 ④ 全文与三个脚本关键词扫描无可疑指令或混淆代码 ⑤ 官方仓库、具名工程师维护，无造假迹象 ⑥ MIT 许可证明确 ⑦ 最近提交 10 天内，维护活跃。
7. 跟同类 Skills 相比的优势
| 竞品 | 定位 | 与本技能的差异 |
|---|---|---|
| skill-creator（Anthropic 官方） | 通用型 skill 创建工具，核心是强制做“带/不带 skill”对照实验、量化触发准确率 | 面向任意领域的通用 skill，本技能则专精 Azure SDK/Foundry 场景，强调 SDK 文档时效性与多语言模式库 |
| SkillOpt（Microsoft Research） | 把已有 SKILL.md 当作可训练参数，用验证门控的自动文本编辑持续优化 | 是全自动的持续优化循环，不涉及从零指导编写；本技能是人工编写阶段的方法论与脚手架，两者可互补而非替代 |
| functional-skill-creator | 用函数式编程思路拆解膨胀的 SKILL.md，按输入/输出契约重构 | 聚焦“重构维护”已有技能，本技能聚焦“从零创建”且绑定 Azure/Foundry 领域知识 |
8. 用户评价
该技能目前在第三方平台尚无独立具名用户评价；已确认有其他仓库贡献者（如 samvaity、arimu1）通过 Pull Request 参与该技能内容的迭代改进。
9. 安装使用方式
- 推荐方式：在项目根目录运行
npx skills add microsoft/skills，在交互向导中勾选skill-creator，工具会自动放入当前 agent 对应的技能目录（如 Claude Code 为.claude/skills/） - 手动方式：
git clone https://github.com/microsoft/skills.git cp -r skills/.github/skills/skill-creator your-project/.claude/skills/ - 安装后无需重启，正常按 SKILL.md 的
description触发条件由 agent 自动调用；如需初始化新技能，可直接运行python .claude/skills/skill-creator/scripts/init_skill.py <skill-name> --path <path>
10. 注意事项
- 内容专精 Azure SDK / Microsoft Foundry 场景，若用于该领域之外的 skill 创作，需自行判断哪些原则（如渐进式披露、自由度分级）具有跨领域适用性，哪些内容（如 SDK 命名模式表）可忽略
- 创建 SDK/API 类技能时要求用户明确提供 SDK 包名、文档链接或仓库引用，无法凭空生成
- 跨 Agent 兼容性除 Claude Code 有明确证据外，其余三个生态均未验证，实际使用前建议先手动测试触发效果