用途：create-skill 指导用户创建有效的 Agent Skills。技能是 Markdown（外加可选脚本），用来教智能体一个聚焦的工作流；当你想创建、撰写或编写新技能，或询问技能结构、最佳实践时使用。
存放位置：仓库内 .claude/skills/<name>/ 为 n8n 默认位置，团队共享并纳入版本管理，在有该仓库时 Cursor 也会读取项目技能；~/.claude/skills/<name>/ 是 Claude Code 跨项目的个人技能；~/.cursor/skills/<name>/ 是可选的 Cursor 个人全局技能。不要把自定义技能放进 ~/.cursor/skills-cursor/，那是 Cursor 内置技能专用。需要与团队做法一致的内容优先放仓库 .claude/skills/。
写前先收集需求：明确一个具体任务或工作流、触发时机、智能体尚不知道的信息（项目规则、URL、格式）、所需输出（模板、清单或严格格式），并尽量参考 .claude/skills/ 中已有技能。
文件布局：skill-name/ 下含必需的 SKILL.md，可选 reference.md、examples.md 和 scripts/。Frontmatter 必填 name（小写、连字符、最多 64 字符）与 description（非空、最多 1024 字符，第三人称，写清做什么和何时用，含触发词）。
编写规则：简洁，只补非显而易见的领域或项目事实；渐进披露，核心放 SKILL.md，长参考放 reference.md，且只向上链接一层；优先给出一个默认方案，确有需要再留退路；术语稳定，一个概念一个词；路径只用正斜杠；SKILL.md 尽量远低于约 200 行。
范围：一个技能一个职责，触发和步骤差异大的应拆分；偏好小而可组合的技能，父级编排技能说明何时走各子流程并链接其 SKILL.md，不要粘贴全文。单一始终一起运行的端到端流程可保留为一个较大技能。
MCP、CLI 与其他技能：能用 CLI 和仓库命令解决时优先使用（如 gh、pnpm 脚本）。MCP 因人而异，若技能依赖特定 MCP，应在 description 中提示，并在顶部加简短前置条件与缺失时的回退方案；引用其他技能要给出仓库根路径或相对链接；父技能应委派而非复制长流程。
常用模式：模板（确切输出形态）、清单（编号或 - [ ] 步骤）、分支（If A / If B）、脚本（记录运行命令，说明是执行还是阅读）。创建流程为先命名与描述，再列大纲、实现 SKILL.md、最后检查。
反模式：技能内写冗长教程；给多个等价选项而无默认；名称含糊如 helper、utils；深层链接文件；假定 MCP 或工具存在而不声明或提供回退；用一个超大技能混合无关工作流。
限制：官方资料未提供具体定价、平台支持范围、效果数据与完整示例代码，相关事实暂未提供。