尧图网页设计 
SKILL.md是什么Wondel.ai Agent Skills文件结构、触发机制与评分设计完全指南【免费下载链接】skillsWondel.ai Agent Skills — Business, Marketing, UX Coding Frameworks from Bestselling Books. 50 skills 12 guided journeys for Claude Code, Codex, Cursor other agentskills.io agents.项目地址: https://gitcode.com/gh_mirrors/skills25/skillsSKILL.md是 AI Agent 技能体系的核心文件。在Wondel.ai Agent Skills这个开源项目中一份份精心编写的 SKILL.md 把《精益创业》《影响力》《重构》等畅销书的方法论变成了 AI 能直接调用的框架——全套 62 个 Agent Skills50 个专家框架 12 条引导式旅程适用于 Claude Code、Codex、Cursor 等所有支持 agentskills.io 标准的 Agent。这篇文章带你从零看懂 SKILL.md 的文件结构、触发机制和评分设计。什么是SKILL.md一个文件让AI变身专家 一句话理解SKILL.md YAML 元信息 Markdown 正文。YAML 部分frontmatter告诉 Agent我是谁、什么时候该用我Markdown 部分告诉 Agent按什么方法论帮你干活每个技能就是一个独立目录结构极其简单组成说明示例{skill-name}/技能目录小写连字符命名clean-code/SKILL.md技能主文件必有clean-code/SKILL.mdreferences/参考文件可选1500-3000词/篇clean-code/references/naming-conventions.md你可以参考仓库导航文件 CLAUDE.md 了解完整的仓库结构——它明确了每个目录的角色以及哪些内容是脚本自动生成的。SKILL.md文件结构从YAML头到正文的完整拆解YAML Frontmattername与description两个必填字段以 clean-code/SKILL.md 为例文件开头的 YAML 头长这样字段规则示例name唯一标识小写连字符最多 64 字符clean-codedescription技能做什么何时使用最多 1024 字符建议用编号用例见下方说明license许可证市场推荐MITmetadata.author作者市场推荐wondelaimetadata.version语义化版本号1.4.0description是整个文件的灵魂官方要求使用编号使用场景格式(1) 场景一, (2) 场景二, (3) 场景三。注意 YAML 中单引号要用双单引号转义——create-business/SKILL.md 的 description 里就能看到这个细节。正文部分标准章节模板根据 CLAUDE.md 定义的规范一个完整的书系技能正文按此顺序组织标题 引言段框架总览Core Principle加粗核心原则 基础说明Scoring评分标准下一节详述Framework Sections每个小节固定包含Core concept / Why it works / Key insights / 应用表格并在需要时内联指向 references 的按需阅读指针Common MistakesMistake | Why It Fails | Fix三列表格Quick DiagnosticQuestion | If No | Action诊断表Further Reading / About the Author延伸阅读与作者介绍这种原则先行、诊断收尾的结构让 Agent 既能快速定位方法论也能用统一标准输出可验证的结论。触发机制description字段决定AI何时想起你 SKILL.md 不靠按钮触发而是靠description 字段的关键词与触发短语进行语义匹配。这是整个项目最值得学习的设计三层触发设计主题关键词如 code smells、naming conventions、boy scout rule口语化触发句直接列出用户可能说出的原话如 clean up this code、this function is too long编号场景(1) 审 PR 可读性 (2) 拆解混乱函数 (3) 讨论注释风格...在 clean-code/SKILL.md 的 description 中可以看到完整示范它同时覆盖了主题词、用户原话和 3 类触发场景结尾还标注了重构技巧请看 refactoring-patterns——技能之间互相划清边界避免误触发。元技能Metaskill的负向触发12 条引导式旅程使用 5 句式 description 公式其中第 4 句专门写不该使用它的场景并路由给姊妹技能。例如 create-business/SKILL.md 明确写道业务已有付费客户时请勿使用本技能用 grow-business 增收用 improve-business 修战略。 这种双向路由保证了 12 条旅程之间互不冲突。多IDE同步一份SKILL.md处处可用安装技能后scripts/sync-ide-skills.sh 会自动扫描所有包含 SKILL.md 的顶层目录并在.claude/skills、.cursor/skills、.windsurf/skills、.agents/skills等目录生成符号链接——一份 SKILL.md 就能同时被 Claude、Cursor、Codex 等多款 Agent 识别加载。评分设计Goal 10/10如何给产出打分 这套体系最有特色的设计之一是每个技能都内置评分系统Scoring让 AI 的评估从感觉还行变成可复现的分数规则一目标锚定 10/10—— 明确要求 Agent 给出当前分 达到满分的具体改进项。规则二分数必须由可复现规则算出—— 官方要求分数与 Quick Diagnostic 诊断表挂钩例如score round(通过题数 / 总题数 × 10)并禁止每题 1 分这种让满分不可达的粗糙规则。规则三五档分位描述—— 以 clean-code/SKILL.md 的评分段为例分数对应表现9-10命名即意图、函数小而聚焦、错误处理一致、测试完备7-8基本干净少量命名模糊或长函数5-6好坏混杂存在重复逻辑或不一致处理3-4多功能长函数、误导性命名、测试缺失1-2几乎不可读魔法数字、加密缩写、无结构这套设计让帮我 review 代码这类请求有了统一输出格式分数 差距 改进清单新手也能看懂 AI 的评判依据。进阶Metaskill如何让SKILL.md编排一场旅程 ️除了 50 个单点技能项目还有 12 条 Metaskill如 create-business/SKILL.md它们的 SKILL.md 走完全不同的模板Journey MapPhase | Skill | 回答的问题 | 产物四列表把 10 个阶段逐一编排Operating Rules12 个旅程共享 7 条词序一致的操作规则 1 条专属护栏Phases每阶段固定 6 字段——Purpose、Brief、Invoke、Decide with the user、Artifact、Done when状态持久化所有决策写入用户项目的docs/目录如CUSTOMER.md、POSITIONING.md跨会话可断点续跑产物模板的契约统一收录在 docs/ARTIFACT-REGISTRY.md防止 12 个旅程各自为政。想体验完整提示词示例可看 EXAMPLES.md 中按角色整理的 92 个即用型 Prompt。如何安装和使用这些Agent Skills安装只需两步以 Claude Code 为例/plugin marketplace add wondelai/skills /plugin install code-craftsmanshipwondelai-skills项目按主题打包成 10 个集合product-strategy、ux-design、marketing-cro、sales-influence、product-innovation、strategy-growth、code-craftsmanship、systems-architecture、team-motivation和metaskills。也支持 skills.sh 命令逐个安装。版本号遵循语义化版本策略内容增强升 MINOR、笔误修复升 PATCH详见 CLAUDE.md 的 Versioning Policy 章节。常见问题速答 Q写 SKILL.md 最少需要哪些字段A只有name和description两个必填字段其余为市场推荐项。Q为什么 AI 有时不触发我的技能A检查 description 是否包含用户会说的原话和主题关键词并确保编号使用场景覆盖了典型请求。Qreferences 文件是必须的吗A不是但官方建议每个技能配 1500-3000 词的参考文件并在正文中用按需阅读指针在需要的时刻引导 Agent 打开它。总结SKILL.md 用一个极轻的文件约定把何时触发、如何执行、如何评分三件事标准化YAML 头负责被发现正文负责被正确执行Scoring 负责被可验证地评估。无论你想让 AI 掌握《精益创业》的 Build-Measure-Learn还是《代码整洁之道》的命名纪律读懂这份 SKILL.md 设计规范你也能为自己的 Agent 编写高质量技能。【免费下载链接】skillsWondel.ai Agent Skills — Business, Marketing, UX Coding Frameworks from Bestselling Books. 50 skills 12 guided journeys for Claude Code, Codex, Cursor other agentskills.io agents.项目地址: https://gitcode.com/gh_mirrors/skills25/skills创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 SKILL.md是什么？Wondel.ai Agent Skills文件结构、触发机制与评分设计完全指南
SKILL.md是什么Wondel.ai Agent Skills文件结构、触发机制与评分设计完全指南【免费下载链接】skillsWondel.ai Agent Skills — Business, Marketing, UX Coding Frameworks from Bestselling Books. 50 skills 12 guided journeys for Claude Code, Codex, Cursor other agentskills.io agents.项目地址: https://gitcode.com/gh_mirrors/skills25/skillsSKILL.md是 AI Agent 技能体系的核心文件。在Wondel.ai Agent Skills这个开源项目中一份份精心编写的 SKILL.md 把《精益创业》《影响力》《重构》等畅销书的方法论变成了 AI 能直接调用的框架——全套 62 个 Agent Skills50 个专家框架 12 条引导式旅程适用于 Claude Code、Codex、Cursor 等所有支持 agentskills.io 标准的 Agent。这篇文章带你从零看懂 SKILL.md 的文件结构、触发机制和评分设计。什么是SKILL.md一个文件让AI变身专家 一句话理解SKILL.md YAML 元信息 Markdown 正文。YAML 部分frontmatter告诉 Agent我是谁、什么时候该用我Markdown 部分告诉 Agent按什么方法论帮你干活每个技能就是一个独立目录结构极其简单组成说明示例{skill-name}/技能目录小写连字符命名clean-code/SKILL.md技能主文件必有clean-code/SKILL.mdreferences/参考文件可选1500-3000词/篇clean-code/references/naming-conventions.md你可以参考仓库导航文件 CLAUDE.md 了解完整的仓库结构——它明确了每个目录的角色以及哪些内容是脚本自动生成的。SKILL.md文件结构从YAML头到正文的完整拆解YAML Frontmattername与description两个必填字段以 clean-code/SKILL.md 为例文件开头的 YAML 头长这样字段规则示例name唯一标识小写连字符最多 64 字符clean-codedescription技能做什么何时使用最多 1024 字符建议用编号用例见下方说明license许可证市场推荐MITmetadata.author作者市场推荐wondelaimetadata.version语义化版本号1.4.0description是整个文件的灵魂官方要求使用编号使用场景格式(1) 场景一, (2) 场景二, (3) 场景三。注意 YAML 中单引号要用双单引号转义——create-business/SKILL.md 的 description 里就能看到这个细节。正文部分标准章节模板根据 CLAUDE.md 定义的规范一个完整的书系技能正文按此顺序组织标题 引言段框架总览Core Principle加粗核心原则 基础说明Scoring评分标准下一节详述Framework Sections每个小节固定包含Core concept / Why it works / Key insights / 应用表格并在需要时内联指向 references 的按需阅读指针Common MistakesMistake | Why It Fails | Fix三列表格Quick DiagnosticQuestion | If No | Action诊断表Further Reading / About the Author延伸阅读与作者介绍这种原则先行、诊断收尾的结构让 Agent 既能快速定位方法论也能用统一标准输出可验证的结论。触发机制description字段决定AI何时想起你 SKILL.md 不靠按钮触发而是靠description 字段的关键词与触发短语进行语义匹配。这是整个项目最值得学习的设计三层触发设计主题关键词如 code smells、naming conventions、boy scout rule口语化触发句直接列出用户可能说出的原话如 clean up this code、this function is too long编号场景(1) 审 PR 可读性 (2) 拆解混乱函数 (3) 讨论注释风格...在 clean-code/SKILL.md 的 description 中可以看到完整示范它同时覆盖了主题词、用户原话和 3 类触发场景结尾还标注了重构技巧请看 refactoring-patterns——技能之间互相划清边界避免误触发。元技能Metaskill的负向触发12 条引导式旅程使用 5 句式 description 公式其中第 4 句专门写不该使用它的场景并路由给姊妹技能。例如 create-business/SKILL.md 明确写道业务已有付费客户时请勿使用本技能用 grow-business 增收用 improve-business 修战略。 这种双向路由保证了 12 条旅程之间互不冲突。多IDE同步一份SKILL.md处处可用安装技能后scripts/sync-ide-skills.sh 会自动扫描所有包含 SKILL.md 的顶层目录并在.claude/skills、.cursor/skills、.windsurf/skills、.agents/skills等目录生成符号链接——一份 SKILL.md 就能同时被 Claude、Cursor、Codex 等多款 Agent 识别加载。评分设计Goal 10/10如何给产出打分 这套体系最有特色的设计之一是每个技能都内置评分系统Scoring让 AI 的评估从感觉还行变成可复现的分数规则一目标锚定 10/10—— 明确要求 Agent 给出当前分 达到满分的具体改进项。规则二分数必须由可复现规则算出—— 官方要求分数与 Quick Diagnostic 诊断表挂钩例如score round(通过题数 / 总题数 × 10)并禁止每题 1 分这种让满分不可达的粗糙规则。规则三五档分位描述—— 以 clean-code/SKILL.md 的评分段为例分数对应表现9-10命名即意图、函数小而聚焦、错误处理一致、测试完备7-8基本干净少量命名模糊或长函数5-6好坏混杂存在重复逻辑或不一致处理3-4多功能长函数、误导性命名、测试缺失1-2几乎不可读魔法数字、加密缩写、无结构这套设计让帮我 review 代码这类请求有了统一输出格式分数 差距 改进清单新手也能看懂 AI 的评判依据。进阶Metaskill如何让SKILL.md编排一场旅程 ️除了 50 个单点技能项目还有 12 条 Metaskill如 create-business/SKILL.md它们的 SKILL.md 走完全不同的模板Journey MapPhase | Skill | 回答的问题 | 产物四列表把 10 个阶段逐一编排Operating Rules12 个旅程共享 7 条词序一致的操作规则 1 条专属护栏Phases每阶段固定 6 字段——Purpose、Brief、Invoke、Decide with the user、Artifact、Done when状态持久化所有决策写入用户项目的docs/目录如CUSTOMER.md、POSITIONING.md跨会话可断点续跑产物模板的契约统一收录在 docs/ARTIFACT-REGISTRY.md防止 12 个旅程各自为政。想体验完整提示词示例可看 EXAMPLES.md 中按角色整理的 92 个即用型 Prompt。如何安装和使用这些Agent Skills安装只需两步以 Claude Code 为例/plugin marketplace add wondelai/skills /plugin install code-craftsmanshipwondelai-skills项目按主题打包成 10 个集合product-strategy、ux-design、marketing-cro、sales-influence、product-innovation、strategy-growth、code-craftsmanship、systems-architecture、team-motivation和metaskills。也支持 skills.sh 命令逐个安装。版本号遵循语义化版本策略内容增强升 MINOR、笔误修复升 PATCH详见 CLAUDE.md 的 Versioning Policy 章节。常见问题速答 Q写 SKILL.md 最少需要哪些字段A只有name和description两个必填字段其余为市场推荐项。Q为什么 AI 有时不触发我的技能A检查 description 是否包含用户会说的原话和主题关键词并确保编号使用场景覆盖了典型请求。Qreferences 文件是必须的吗A不是但官方建议每个技能配 1500-3000 词的参考文件并在正文中用按需阅读指针在需要的时刻引导 Agent 打开它。总结SKILL.md 用一个极轻的文件约定把何时触发、如何执行、如何评分三件事标准化YAML 头负责被发现正文负责被正确执行Scoring 负责被可验证地评估。无论你想让 AI 掌握《精益创业》的 Build-Measure-Learn还是《代码整洁之道》的命名纪律读懂这份 SKILL.md 设计规范你也能为自己的 Agent 编写高质量技能。【免费下载链接】skillsWondel.ai Agent Skills — Business, Marketing, UX Coding Frameworks from Bestselling Books. 50 skills 12 guided journeys for Claude Code, Codex, Cursor other agentskills.io agents.项目地址: https://gitcode.com/gh_mirrors/skills25/skills创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考