智能体技能构建器

在浏览器中把 Markdown 草稿整理为 Claude 或 Codex SKILL.md 文件。

技能构建工作台
生成的 SKILL.md
Frontmatter 已就绪 正文已就绪
什么是 SKILL.md 文件?

智能体技能是一个包含 SKILL.md 文件的文件夹,用来告诉编码智能体如何处理某一类任务。文件以带 name 和 description 的 YAML frontmatter 开头,后面是 Markdown 指令。智能体依据 description 判断何时使用该技能,所以这一行决定了技能是否会被用到。

构建器如何工作

粘贴或撰写 Markdown 草稿,构建器就会在这个浏览器标签页内把它改写成有效的技能文件。草稿中已有的 frontmatter 会在写入新块之前删除,换行符和重复空行会被规范化,若草稿有 H1,第一个 H1 会成为显示标题。输出是固定格式的 YAML frontmatter,加上标题以及 When to Use 和 Instructions 两个部分。

常见使用场景
  • 从粗略 Markdown 笔记起草新的 Claude 或 Codex 技能
  • 保存 SKILL.md 文件前清理已有 frontmatter
  • 不调用 AI API,准备浏览器本地的技能交接
  • 把运维手册或事故检查清单变成智能体能自行选用的技能
  • 重写智能体从不触发的技能,让描述写明适用情境而不是功能本身
构建器保证什么
  • 固定格式的 YAML frontmatter,包含智能体用于匹配的 name 和 description
  • 添加新块之前先移除已有的 frontmatter
  • 统一换行符并合并重复空行
  • 每个生成的文件都包含标题以及 When to Use 和 Instructions 部分
  • 整理过程完全在这个浏览器标签页内完成,不调用任何外部 AI API
示例
输入: # Quick Triage Helper
输出: name: quick-triage-helper
输入: --- title: old ---
输出: 移除旧的 frontmatter,写入新的 name 和 description
输入: ~/.claude/skills/quick-triage-helper/SKILL.md
输出: 作为个人技能时生成文件的保存位置
常见问题

生成的文件放在哪里?

把它保存为 SKILL.md,放在以技能名命名的文件夹里:个人技能用 ~/.claude/skills/<name>/SKILL.md,若要整个仓库共享,则放在项目内的 .claude/skills/<name>/SKILL.md。

什么样的描述才能让智能体选中这个技能?

写清楚应该在什么情境下触发,而不是罗列功能。以“何时使用”开头的描述胜过只是复述标题的描述,因为智能体会拿描述去比对眼前的任务。

我的草稿会离开浏览器吗?

不会。整理和 frontmatter 生成都在这个标签页内完成,不调用任何 AI API。除非你自己把结果复制到别处,否则什么都不会上传。

输出能用于 Claude 以外的智能体吗?

输出是带 YAML frontmatter 的普通 Markdown,因此任何从文件夹加载技能文件的智能体都能读取。不同工具之间只有安装路径不同。

生成之后还能继续编辑吗?

可以。输出只是起点。Instructions 部分随意修改,需要重写 frontmatter 时再把草稿放进构建器跑一遍即可。