📦 Skill — 技能

技能创建者 该技能为创建高效技能提供指导。

关于技能 技能是模块化、自包含的包，通过提供专业知识、工作流和工具来扩展 Claude 的能力。把它们看作特定领域或任务的“入职指南”——将 Claude 从通用代理转变为具备程序性知识的专用代理，这些知识是任何模型都无法完全拥有的。

技能提供什么

• 专用工作流：特定领域的多步骤程序
• 工具集成：与特定文件格式或 API 协作的指令
• 领域专长：公司专有知识、模式、业务逻辑
• 打包资源：脚本、参考资料和资产，用于复杂且重复的任务

核心原则 简洁至上 上下文窗口是公共资源。技能与系统提示、对话历史、其他技能元数据及用户请求共享该窗口。 默认假设：Claude 已经很聪明。只补充它不知道的内容。 对每条信息追问：“Claude 真的需要这个解释吗？”“这段文字值得消耗 token 吗？” 优先用简洁示例，而非冗长说明。

设定适当自由度 根据任务的脆弱性与可变性调整具体程度：

• 高自由度（文本指令）：多种方法可行、决策依赖上下文、用启发式指导。
• 中自由度（伪代码或带参脚本）：存在偏好模式、允许部分变化、配置影响行为。
• 低自由度（特定脚本、极少参数）：操作易错、需一致性、必须按序执行。

技能结构 每个技能包含必需的 SKILL.md 和可选打包资源： skill-name/ ├── SKILL.md（必需） │ ├── YAML 前置元数据（必需） │ │ ├── name:（必需） │ │ └── description:（必需） │ └── Markdown 指令（必需） └── 打包资源（可选） ├── scripts/ 可执行代码（Python/Bash 等） ├── references/ 按需加载的文档 └── assets/ 输出中使用的文件（模板、图标、字体等）

SKILL.md（必需）

• 前置元数据（YAML）：仅含 name 与 description，Claude 仅读取这两项来决定何时调用技能，务必清晰全面。
• 正文（Markdown）：技能触发后才加载的指令与指导。

打包资源（可选） Scripts/ 可执行代码（Python/Bash 等），用于需确定性或反复重写的任务。 何时放入：同一段代码被反复重写或需绝对可靠。 示例：scripts/rotate_pdf.py 优点：省 token、确定性强、可无需加载至上下文即可执行。

References/ 按需加载的文档与参考资料，供 Claude 工作时查阅。 何时放入：Claude 应在过程中引用的文档。 示例：references/finance.md、references/mnda.md、references/policies.md、references/api_docs.md 用途：数据库模式、API 文档、领域知识、公司政策、详细工作流指南。 最佳实践：文件过大（>1 万词）时，在 SKILL.md 中给出 grep 搜索模式；避免与 SKILL.md 重复，把详细资料放此处，保持 SKILL.md 精简。

Assets/ 不加载至上下文，仅用于最终输出的文件。 何时放入：技能需在输出中使用的外部文件。 示例：assets/logo.png、assets/slides.pptx、assets/frontend-template/、assets/font.ttf