mcpField
C
create-skill

create-skill

github.com/lwlee2608Agent 工作流1178 次安装1 天前更新
代码仓库

关于 create-skill

create-skill 是面向 Agent 技能作者的指南，帮助编写符合质量要求的 SKILL.md。它强调清晰触发条件、独立职责和简洁的规则，而非固定脚本。

主要功能

  1. 01单一职责的技能设计
  2. 02命名与触发描述规范
  3. 03SKILL.md 结构指导
  4. 04编写简洁规则的原则
  5. 05验证与错误记录准则

适用场景

  1. 01创建新的 Agent 技能文件
  2. 02改进技能名称和激活条件
  3. 03精简冗长或重复的技能说明

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/lwlee2608/agent-skills --skill create-skill

安装后在 Claude Code 中输入/create-skill确认已加载。

详细介绍

创建 Agent Skill

指导创建符合质量标准的 SKILL.md 文件。

规则

  1. 一个 skill，只做一件事。 如果需要用“和”来描述，就拆分开。

  2. 为其取个好名字。 优先使用动名词形式（processing-pdfs）。名词短语（pdf-processing）和动作形式（process-pdfs）也可以。避免使用 utils 或 helpers 这类含糊的名称。规范限制：只能使用小写字母、数字和连字符；最多 64 个字符；不得包含 anthropic 或 claude。

  3. 将描述写成触发条件，使用第三人称。 描述决定 skill 何时激活。以“Use when...”开头，并点明具体条件。使用第一人称的表述（“I can...”）会降低可发现性。最多 1024 个字符。

    • 不佳：“帮助处理图表。”
    • 良好：“Use when creating or fixing ASCII box diagrams to ensure proper alignment.”

  4. 使用以下结构：

    ---
name: <kebab-case-name>
description: <"Use when..." trigger description>
user-invocable: true
---

# <Short Title>

<1-2 sentences: what problem this solves.>

## Rules

<Numbered rules, each starting with a bolded imperative.>

## Verification procedure (if applicable)

<Numbered checks the agent runs on its own work.>

## Common mistakes to watch for (only if observed — see rule 9)

<Observed failure modes and how to avoid them.>

  5. 每条规则都以加粗的祈使句开头（“Use...”“Never...”）。

  6. 编写指南，而非脚本。 说明目标、限制和原因；让 Agent 自行选择步骤。脚本容易失效、耗费 token，而且会随着模型改进而过时。只有在 Agent 无法自行判断时，才提供确切语法或步骤，例如项目专用格式、结构化输出和 bug 规避等脆弱操作。用首选方案和备用方案覆盖 80% 的情况，而不是罗列所有边缘情况。

  7. 解释不明显规则背后的原因， 让 Agent 能够处理边缘情况。

  8. 仅在需要进行具体检查，且 Agent 不会主动执行时，才添加验证流程（例如测量对齐情况、运行验证器）。否则省略。

  9. 只记录已观察到的错误。 只有在有证据时才添加“常见错误”：用户报告、本次会话中出现的失败，或已有记录的 bug。否则省略。凭空猜测会增加 token 并误导读者。

  10. 保持各 skill 相互独立。 不要假设其他 skill 已加载。

  11. 保持简短。 尽量少于 4KB；硬性上限为 500 行。将详细内容移至同级文件（reference.md、examples.md），并在 SKILL.md 中添加链接。链接只保持一层深，因为嵌套文件可能只会被部分读取。

需要注意的常见错误

  • 编造常见错误。 为每条内容注明证据，否则删除（规则 9）。
  • 详细写出标准 CLI 命令。 Agent 知道这些命令，而且较新的模型更熟悉。只有项目专用命令或 bug 规避命令才写出（规则 6）。
  • 句子冗长、信息密集。 这会让 skill 膨胀，却不会增加规则。使用简短、直白的句子（规则 11）。
  • 重复表达同一内容。 例如，验证清单重复规则内容，或两条规则相互重叠。将它们合并，或引用相关规则（规则 11）。

评论

支持 Markdown