Skills Guide

Skills Guide 是将可重复使用的专业知识打包为 Claude 可发现功能的基础规范。它为 SKILL.md 文件提供了标准化模板，确保自动化代理能在个人和项目层级的环境中一致地诠释指令。此系统以模块化的文件指令取代了手动的提示工程，让 Claude 能根据语境启动，从而减少重复输入并提升开发者与项目经理的工作效率。

• 定义了必要的 YAML Frontmatter 要求，包括特定的命名惯例（动名词形式）与描述性触发条件。

• 概述了文件结构模式，包括简单的单一文件技能，以及使用渐进式揭露的复杂多文件模块。

• 提供编写精简且高性能指令的最佳实践，强调使用具体范例与输入/输出对，而非解释基础概念。

• 标准化依赖项管理与本地工具集成，例如集成 Python 脚本以进行数据验证或任务自动化。

• 通过 git 存储库促进项目特定技能的共享，提升团队工作流程的一致性。

• 使用此指南来引导新项目功能，或标准化现有零散的提示库。

• 确保 YAML Frontmatter 中的“description”字段细致且聚焦于意图，因为这是 Claude 自动探索的主要依据。

• 将指令保持在 500 行以内以达到最佳的脉络管理；对于更深入的说明文件，请使用个别参考文件 (例如 FORMS.md, REFERENCE.md)。

• 通过迭代持续验证技能效能；在部署前，使用公用程序脚本与预定义的输入/输出范例来测试代理的可靠性。

• 清楚区分个人全局技能 (~/.claude/skills/) 与项目特定技能 (.claude/skills/)，以维持不同环境间的范围完整性。