Create New Skills(技能创作元技能)
一套教你为 Claude Code 编写新 Agent Skill 的元技能,把技能创建流程固化为可复现的最佳实践。
创建新技能的元技能,要求先读官方文档理解「渐进式披露」三层结构再动手,纯文档生成类。
这个 Skill 能做什么,适合哪些场景?
这是 disler/claude-code-hooks-multi-agent-observability 仓库中打包的四个技能之一,位于 .claude/skills/meta-skill/。它本身不监控代理,而是一份"教 Claude 写技能"的指南:要求先阅读随附的 docs/ 目录中的三份文档,再按八步流程(定义目的、建目录、写 SKILL.md、写说明、写示例、加支撑文件、测试、提交 git)完成技能创作。内容覆盖渐进式披露三层架构、命名规范、frontmatter 限制(name ≤64 字符、description ≤1024 字符)、allowed-tools 可选字段,以及四个完整示例。适合想把领域经验沉淀为可复用技能的 Claude Code 团队。
读取随附的 docs/ 目录下三份必读文档(agent skills 指南、架构概览、设计原则博客);向用户提出四个澄清问题以界定技能范围;在 .claude/skills/<skill-name>/ 或 ~/.claude/skills/ 下创建目录结构;生成含 YAML frontmatter 的 SKILL.md(name、description、可选 allowed-tools),正文包含 Prerequisites、Workflow、Examples 三个部分;按需创建 scripts/、templates/、guidelines/ 等支撑文件并在正文中以相对路径引用;用 ls 和 head 验证文件结构与 frontmatter;最后通过 git 提交使技能自动共享给团队成员。
- 工程团队想把内部代码评审流程(如 PEP 8 检查)封装成技能,随仓库共享给全员
- 数据分析师想把带 pandas/matplotlib 脚本的 CSV 分析流程打包成可复用技能
- 技术写作者想按公司风格指南创建多文件文档技能,用渐进式披露控制上下文加载
- 已有技能的维护者想扩展现有技能,例如给转录技能追加拼写纠正映射文件
- 初次接触 Agent Skills 规范的开发者想系统学习 SKILL.md 的结构与编写惯例
这个 Skill 有哪些优点和局限?
- 流程完整:从需求澄清到 git 提交的八步工作流,每步都有具体命令和模板
- 自带三份必读文档,讲清渐进式披露架构,无需外部资料即可上手
- 四个端到端示例覆盖简单评审、脚本型分析、多文件文档和技能扩展,可直接照抄结构
- 总结了大量从真实技能中提炼的模式与反例(好的/坏的 description 写法)
- 纯 Markdown 指南,无脚本依赖,可在任何支持 Agent Skills 的环境中使用
- 严重绑定 Claude Code 语境:技能应放在 .claude/skills/、团队通过 git 自动共享等机制在其他平台未必成立
- 仓库整体是多代理可观测性系统,此技能只是附带的元技能,仓库本身的文档重心(Bun/Vue 仪表盘、hook 事件)对使用此技能没有帮助
- 没有独立的测试套件或质量验证,技能产出的好坏依赖 Claude 的执行
- License 标注为未知,商用前需自行确认
- 示例中的脚本依赖(如 pandas、matplotlib)只是示意,技能本身不含这些脚本
如何安装这个 Skill?
该技能属于仓库 .claude/ 目录的一部分。按 README 的做法,把整个 .claude 目录复制到你的项目根目录:cp -R .claude /path/to/your/project/,技能即位于 .claude/skills/meta-skill/。仓库未提供单独安装这一个技能的说明;若只想要它,可手动复制 meta-skill 文件夹(含 SKILL.md 和 docs/)到项目的 .claude/skills/ 下。未提供 License 信息。
如何使用这个 Skill?
在 Claude Code 中触发它即可,无需命令行操作。触发方式:让 Claude 创建新技能,例如输入"Create a skill that reviews Python code for best practices"或"把我们的风格指南做成一个文档技能"。SKILL.md 的 description 指明触发场景是用户想创建新技能、扩展 Claude 能力或打包领域专长。启动后它会先要求阅读 docs/ 目录,再逐步引导你完成定义、创建、测试与 git 提交。
这个 Skill 与同类方案有什么区别?
与官方 Anthropic Agent Skills 文档相比,这份技能把规范压缩成了带步骤和示例的实操指南,更适合在对话中直接执行;但它面向 Claude Code 的目录约定和 git 共享机制,可移植性弱于纯规范文档。