Create Skills

核心用法

document-skills 是 Claude Code 生态中的元技能（meta-skill），用于将用户草稿或现有技能转化为符合官方最佳实践的标准化技能文档。用户可通过自然语言指令（如 "document a skill"、"write a skill"、"/document-skills"）触发，或直接调用 /document-skills [skill-path] [source] 命令。

该技能严格遵循 SKILL.md 五段式结构：
1. Title（技能名称与简介）
2. Inputs（输入参数说明，支持 $ARGUMENTS 与 $N 占位符）
3. Output（交付物描述）
4. Process（执行步骤与规则，核心逻辑所在）
5. Reference（关联技能与文档链接）

关键特性：

• 智能 Frontmatter 配置：自动识别需用户手动触发的任务（disable-model-invocation: true）、隐藏技能（user-invocable: false）、工具权限白名单（allowed-tools）等
• 长度管控：强制将 SKILL.md 控制在 500 行以内，长引用内容外移至 reference.md 或 examples/
• 多层级部署：支持项目级（.claude/skills/）与个人级（~/.claude/skills/）技能目录，嵌套目录自动发现

显著优点

• 权威性：直接源自 Anthropic 官方 Claude Code 文档规范，代表当前技能编写的黄金标准
• 一致性：通过强制结构模板消除团队成员间的文档风格差异
• 自动化：集成参数解析（$ARGUMENTS、${CLAUDE_SKILL_DIR} 等）、动态上下文注入（pre-run shell output）
• 可发现性：description 字段优化自然语言触发，提升 Claude 自动路由准确率
• 可维护性：清晰的 Input/Process/Output 分离，便于后续迭代与新人上手

潜在缺点与局限性

• 约束性强：严格的长度与结构限制可能不适合超复杂技能（需拆分多文件）
• YAML 敏感：Frontmatter 中禁止冒号等字符，需改写为 "Scope is" 等替代句式
• 无安全扫描：官方说明文件未包含权限审计、恶意代码检测等安全机制（依赖人工审核）
• 版本锁定：紧密跟随 Claude Code 官方规范演进，旧版本技能可能需手动迁移

适合人群

| 场景 | 推荐度 |

|------|--------|

| Claude Code 重度用户，需建立团队技能库 | ⭐⭐⭐⭐⭐ |

| 需要快速将内部工作流文档化为可复用技能 | ⭐⭐⭐⭐⭐ |

| 追求文档一致性、需 Code Review 标准化 | ⭐⭐⭐⭐⭐ |

| 简单一次性任务，无需长期维护 | ⭐⭐⭐☆☆ |

| 高度定制化、超出官方模板的复杂场景 | ⭐⭐☆☆☆ |

常规风险

• 权限误配：allowed-tools 配置不当可能导致 Claude 意外执行敏感操作（如 Bash(rm -rf *)）
• 上下文泄露：context: fork 任务需确保子代理不暴露敏感会话信息
• 注入风险：动态上下文注入功能若引用外部命令输出，需验证来源可信度
• 覆盖风险：更新现有技能时，未明确 --force 或确认机制可能导致用户自定义内容丢失

核心用法

document-skills 是 Claude Code 官方提供的元技能（Meta Skill），用于将用户输入或草稿转换为符合规范的 SKILL.md 文件。用户通过 /document-skills [skill-path] [source] 调用，输入目标技能路径和可选的源材料，即可获得标准化、结构化的技能文档。

显著优点

1. 权威性保障：直接来自 Anthropic 官方，严格遵循 Claude Code 文档规范，确保生成的技能能被正确识别和调用。
2. 结构化输出：强制采用统一的五段式结构（Inputs → Output → Process → Reference），大幅提升技能可维护性。
3. 安全纯净：纯 Markdown 文档，无可执行代码、无外部依赖、无网络调用，从根本上杜绝供应链攻击和恶意代码注入风险。
4. 智能提示：description 字段设计支持自然语言关键词匹配，使 Claude 能自动识别何时应调用该技能。

潜在局限

• 功能单一：仅专注于文档生成，不具备代码审查、测试执行等工程能力。
• 依赖人工输入：需要用户提供清晰的源材料或需求描述，无法完全自主推断技能意图。
• 规范约束严格：对于追求高度定制化的用户，标准模板可能显得僵化。

适合人群

• 需要快速创建 Claude Code 技能的开发者
• 团队协作中需要统一技能文档规范的 Tech Lead
• 希望将现有脚本或工作流封装为可复用 Skill 的用户

常规风险

该技能本身为 T-MD（纯 Markdown）类别，无可执行代码，通过全部六项安全检测（静态分析、动态行为、依赖审计、网络流量、隐私合规、威胁情报），安全等级 S+。主要风险在于用户可能误用生成的技能（如赋予不当的 allowed-tools 权限），而非 document-skills 本身。