Skill Forge

一个帮助你从零创建、审查和优化 Agent Skills 的完整工作流指南。

简介

Skill Forge 是一套面向 Claude Code 等 AI Agent 平台的技能开发工具。它提供了结构化的方法、可复用的模板和最佳实践参考，帮助你把日常工作流转化为高质量的 Agent Skills。

无论你是第一次写技能，还是想优化现有技能的触发率和输出质量，这套资源都能提供系统性的指导。

适用场景

• 想要把重复性任务封装成可复用的 Agent Skill
• 需要优化现有技能的 description 以提高触发准确率
• 想学习 Agent Skills 的格式规范和设计模式
• 正在评估自己技能的质量并寻找改进方向

目录结构

skill-forge/
├── SKILL.md                      # 核心技能文件：创建/审查/优化技能的完整工作流
├── assets/
│   └── skill-template.md         # SKILL.md 的标准模板
└── references/
    ├── specification.md          # Agent Skills 完整格式规范
    ├── best-practices.md         # 技能设计的最佳实践
    ├── evaluating-skills.md      # 技能质量评估方法
    ├── optimizing-descriptions.md # 描述文案优化指南
    ├── add-skills-support.md     # 在项目中添加技能支持的方法
    └── using-scripts.md          # 如何在技能中捆绑和使用脚本

快速开始

1. 创建新技能

从模板开始：

cp assets/skill-template.md my-skill/SKILL.md

然后参考 SKILL.md 中的Skill creation workflow逐步完善：

1. 理解任务 — 明确技能要解决的问题和边界
2. 设计结构 — 决定哪些内容放入 SKILL.md，哪些放入 references/
3. 撰写 SKILL.md — 填写 frontmatter（name + description）和正文指令
4. 质量审查 — 对照检查清单验证命名、长度、引用路径等
5. 测试迭代 — 在真实场景中测试并根据结果调整

2. 优化现有技能

你的需求	参考文档
技能触发率太低	references/optimizing-descriptions.md
输出质量不稳定	references/evaluating-skills.md
不知道格式是否合规	references/specification.md
想让指令更精炼	references/best-practices.md
需要捆绑脚本	references/using-scripts.md

核心原则

• 添加智能体缺乏的，省略它已知的 — 聚焦项目特定约定和边缘情况，不必解释 HTTP 或数据库是什么
• 提供默认方案，而非菜单 — 多个选项并存时，选一个主推，其他简要提及
• 过程优于声明 — 教智能体"如何解决问题"，而非"某一特定情况下的产出"
• 渐进式披露 — 主文件控制在 500 行以内，详细内容按需加载

参考资源

• Agent Skills 官方规范
• 描述优化完整指南
• 技能质量评估框架

---

Skill Forge 本身也是一个 Agent Skill — 你可以直接将其放入 Claude Code 的技能目录中使用。