Create Skills

核心用法

document-skills 是 Anthropic Code 生态系统的官方技能文档工具，用于创建或更新符合规范的 SKILL.md 文件。该工具遵循严格的结构化模板，确保技能在 Claude Code 环境中可自动发现、正确触发和协同工作。

显著优点

官方权威性：直接来自 Anthropic 官方文档，涵盖 frontmatter 完整规范、渐进式披露设计（progressive disclosure）、以及 skills 目录布局标准。

标准化模板：强制使用 [What it does] + [When to use it] + [Key capabilities] 描述公式，确保技能触发精准；统一 Inputs → Output → Process → Examples → Troubleshooting → Reference 的章节顺序。

工程实践完备：

• 支持 disable-model-invocation 和 user-invocable 控制触发方式
• 提供 $ARGUMENTS 参数替换与动态上下文注入机制
• 明确区分 Reference content（知识类）与 Task content（操作类）

渐进式披露架构：YAML frontmatter 常驻加载 → SKILL.md 按需加载 → references/ 延迟加载，优化 token 使用效率。

潜在局限

仅适用于 Anthropic Code 生态：规范与 Claude Code 的 skill discovery 机制深度耦合，无法直接迁移至其他 AI 编程工具。

约束严格：文件夹命名强制 kebab-case、frontmatter 禁用 XML 尖括号、YAML 值避免冒号等规则可能增加初期学习成本。

无内置验证工具：依赖人工遵循 checklist，无自动化 schema 校验（如 description 长度、必填字段完整性）。

适合人群

• Claude Code 重度用户需要自定义工作流技能
• 团队技术负责人统一技能开发规范
• 开源项目维护者贡献标准化技能到公共仓库

常规风险

S 级安全：来源为 Anthropic 官方资源（resources.anthropic.com），无代码执行能力，纯文档模板工具。主要风险在于 frontmatter 格式错误导致 skill 无法被识别，或 trigger 描述过于宽泛造成误触发。文档明确提供 troubleshooting 章节覆盖常见问题。

核心用法

document-skills 是 Claude Code 生态中的文档生成技能，专用于将用户草稿、指令或笔记转化为符合官方规范的 SKILL.md 文件。其核心工作流程包括：解析目标路径与输入源、应用标准化模板（Frontmatter + Inputs/Output/Process/Examples/Troubleshooting/Reference 六段式结构）、执行完整性检查清单（checklist），最终生成可直接投入使用的技能文档。

该技能严格遵循 Anthropic 官方定义的结构规范：文件夹必须为 kebab-case，Frontmatter 必须包含 name（匹配文件夹名）和 description（采用「功能+触发时机+核心能力」三段式，限1024字符，禁用 XML 尖括号），任务类技能需设置 disable-model-invocation: true 防止自动加载。内容组织采用渐进式披露策略——YAML 元数据常驻内存、SKILL.md 主体按需加载、references/ 和 assets/ 目录内容仅在需要时访问。

显著优点

标准化程度极高：完全对齐官方技能参考文档（code.claude.com/docs/en/skills.md）和《Complete Guide to Building Skills》PDF 指南，确保产出物与 Claude Code 宿主系统零摩擦集成。

安全性经过六维验证：静态分析、动态行为、依赖审计、网络分析、隐私合规、威胁情报六项检测全部满分通过，无任何敏感信息泄露、恶意代码模式或外部数据外泄风险。外部链接全部指向 Anthropic 官方域名，属于可信来源。

工程实践完备：内置 Checklist 机制覆盖 12 项关键验证点，从文件夹命名、Frontmatter 格式到参数替换变量（$ARGUMENTS、${CLAUDE_SKILL_DIR}）均有明确指引，大幅降低人工出错概率。

潜在缺点与局限性

无自动化执行能力：该技能本身为纯 Markdown 文档，不产生可执行代码，需依赖 Claude Code 宿主或其他代理完成实际的文件写入操作。用户无法直接「运行」document-skills 获得结果，必须通过对话交互触发。

版本生态依赖：高度绑定 Anthropic 官方技能规范，若官方更新结构标准（如新增 Frontmatter 字段或调整章节顺序），需同步更新 skill 内容。当前版本 0.1.2 尚未建立公开的版本发布流程和社区仓库。

T3 来源可信度：作为个人开发者（ryanallen）贡献的社区项目，缺乏官方背书和企业级维护承诺，建议关键环境进行二次审查。

适合人群

• Claude Code 技能开发者：需要快速创建符合规范的新技能
• DevOps/平台工程师：维护内部技能库，统一文档标准
• 技术写作者：将非结构化需求转化为结构化技能文档
• 开源贡献者：向 Claude Code 生态提交技能PR前的格式自检

常规风险

低——无代码执行风险：纯文档属性消除了传统软件供应链攻击向量（如依赖混淆、恶意脚本注入）。

中——规范漂移风险：若用户未同步更新 coordinator-flows.md 和引用该 skill 的其他 agent，可能导致技能触发逻辑与实际文档描述不一致。技能明确建议「After writing」阶段执行 coordinator 同步，但依赖人工操作。

低——许可证不明：当前标记为 unknown，建议补充 MIT 等明确开源协议以降低企业采纳顾虑。