Writing Skills Skill

Writing Skills 是 Superpowers 的元 Skill（Skill 源码）。在创建新 Skill、修改已有 Skill 或部署前检查 Skill 是否有效时使用，核心观点是：编写 Skill 就是把测试驱动开发用在流程文档上。Superpowers 的贡献指南要求任何 Skill 改动都遵循它。

它的铁律与 TDD 如出一辙："没有先失败的测试，就不写 Skill"，修改同样适用。

核心功能

• TDD 对应关系：测试用例是用子智能体运行的压力场景；红，是智能体在没有 Skill 时违反规则；绿，是有 Skill 后遵守规则；重构，是堵住漏洞。
• 何时该写：不显而易见、可跨项目复用、适用面广的技巧。一次性方案、项目约定、正则就能强制的规则都不该写成 Skill。
• Skill 类型：技巧、模式、参考三类，各有不同的测试方法。
• 描述即触发条件：description 应写何时使用（"Use when..."），而不是概括流程。Skill 举例说明，概括流程的描述曾让智能体只做了一次评审，而 Skill 要求两次。
• 防借口加固：显式堵住每个漏洞，根据真实测试整理借口对照表，并加上危险信号清单。
• 节省 token：保持 Skill 精简，把大篇幅参考或可复用工具放到单独文件。
• 配套文件：Anthropic 的 Skill 最佳实践、说服原则、graphviz 约定，以及用子智能体测试 Skill 的指南。

适用场景

• 为 Claude Code、Codex 或 Gemini CLI 编写团队自己的 Skill。
• 修复总被智能体忽略或用错的 Skill。
• 为 Superpowers 本身贡献代码。

定价

免费开源，MIT 许可证。Superpowers 背后的公司 Prime Radiant 为企业提供商业支持。实际成本主要是 token：流程类 Skill 会增加提问、评审和子智能体运行。

快速开始

Superpowers 以一个插件整体安装，这个 Skill 会连同整套库一起装上（v6.4.1 共 15 个 Skill）。在 Claude Code 中运行 /plugin install superpowers@claude-plugins-official。Cursor 用 /add-plugin superpowers，Gemini CLI 用 gemini extensions install https://github.com/obra/superpowers，Codex、GitHub Copilot CLI、OpenCode、Pi 等工具的命令见 README。Skill 会自动触发，也可以直接点名调用。 然后让智能体"为 X 写一个 Skill"，它应当先跑一遍基线场景再动笔。

局限：用子智能体做压力测试需要实打实的时间和 token，结果也因模型而异，比直接写一个 markdown 文件繁重得多。

常见问题

个人 Skill 放在哪里？

放在运行时的 skills 目录，Claude Code 为 ~/.claude/skills/，一些运行时也会读取 ~/.agents/skills/。

这和 Anthropic 的 Skill Creator 一样吗？

不一样。Skill Creator 侧重模板，这个 Skill 侧重测试智能体是否真的遵守。

替代方案

• Skill Creator：Anthropic 官方的元 Skill。
• Claude Skills：Claude Code 如何加载 Skill。
• Skills Explorer：动手写之前先浏览已有 Skill。

总结

这是我们收录的最严谨的智能体 Skill 写作指南，即使不装 Superpowers 也值得一读。更多见 skills 分类。