name: add-skill description: 通过技能创建，获取官方文档并生成结构良好的新Claude Code技能。当用户想要添加技能、创建斜杠命令或自动化工作流时使用。

添加技能（元技能）

通过获取最新官方文档并生成正确结构的技能文件来创建新的Claude Code技能。

工作流程

步骤 1：获取最新文档

始终先获取官方文档以确保符合当前规范：

WebFetch: https://code.claude.com/docs/en/skills
Prompt: 提取技能文件格式、必填字段、命名规则和最佳实践

如果WebFetch因长度失败，使用WebSearch：

WebSearch: "Claude Code skills SKILL.md format site:code.claude.com"

步骤 2：收集需求

询问用户（使用AskUserQuestion工具）：

名称：该技能应叫什么？（仅小写字母、连字符）
目的：它做什么？（1-2句话）
触发条件：Claude应何时使用它？（关键词、场景）
复杂度：是否需要脚本，或仅指令？

步骤 3：创建技能结构

~/.claude/skills/{技能名称}/
├── SKILL.md           # 必填：主指令
├── scripts/           # 可选：可执行代码
└── references/        # 可选：详细文档

步骤 4：生成 SKILL.md

使用此模板：

---
name: {技能名称}
description: {它做什么}。当{触发条件}时使用。
---

# {技能标题}

{简要概述 - 该技能帮助实现什么}

## 何时使用

- {场景1}
- {场景2}

## 指令

{Claude应遵循的逐步指导}

## 示例

**输入：** {示例用户请求}
**输出：** {预期Claude行为}

步骤 5：验证

在创建前验证：

[ ] 名称：1-64字符，仅小写字母/数字/连字符
[ ] 名称：无前导/尾随连字符-，无连续连字符--
[ ] 描述：清晰说明WHAT + WHEN
[ ] SKILL.md：少于500行（细节放在references/中）
[ ] 目录名与name字段完全匹配

步骤 6：创建文件

mkdir -p ~/.claude/skills/{技能名称}
# 使用Write工具写入SKILL.md

步骤 7：验证

ls -la ~/.claude/skills/{技能名称}/
cat ~/.claude/skills/{技能名称}/SKILL.md

测试：使用claude --debug检查加载错误。

命名规则

规则	有效	无效
仅小写字母	`my-skill`	`My-Skill`
连字符允许	`test-runner`	`test_runner`
数字允许	`v2-helper`	-
无前导/尾随连字符	`skill`	`-skill-`
无连续连字符	`my-skill`	`my--skill`
1-64字符	`a`到64字符	空或65+

最佳实践

描述关键：Claude用它来决定何时调用技能
渐进披露：保持SKILL.md简洁，参考文档放在references/中
总是包含示例：展示预期输入/输出
脚本必须引用：在SKILL.md中明确提及它们
立即测试：使用claude /你的技能验证

快速模式

用于快速创建，用户可一次性提供所有信息：

/add-skill name=my-skill purpose="做X" trigger="当用户请求Y时"

解析并生成，无需交互式提示。

资源

官方文档：https://code.claude.com/docs/en/skills
Anthropic技能仓库：https://github.com/anthropics/skills