如何正确编写Claude Code技能：7个常见错误及避免方法
破坏Claude Code技能的7个错误：没有触发器、通用名称、空白部分、冗长触发器。好技能文件的检查清单。
如何正确编写Claude Code技能
7个技能错误
🔺 没有触发器 — Claude不知道何时调用技能。写"当被要求部署时使用"，而不是"帮助部署"。
🔺 没有具体动作动词 — "处理文件"太模糊。写create、generate、convert、analyze。
🔺 通用名称 — skill、helper、utils。更好的：github-pr-reviewer、dev-browser。
🔺 空白部分 — 没有内容的标题浪费token。没内容就删掉。
🔺 冗长触发器 — 每个多余的token都要花钱。
🔺 没有输出格式 — 技能应该知道返回什么：json、md、纯文本。附带示例。
🔺 矛盾 — 同一文件中"始终使用TypeScript"和"支持任何语言"。
好技能的公式
好技能 = 清晰名称 + 触发时机 + 做什么 + 输出格式。
原文: @danokhlopkov
Dan Okhlopkov — AI智能体实践者。构建TON区块链分析和Telegram自动化工具。