该资料给出 Agent Skill 的设计约定，核心目标是让技能聚焦、易被发现并按需展开细节。
用途：当需要创建、重构或审查 Agent Skill 时使用。技能应承载会改变智能体工作方式的决策、流程与知识，而不是复述智能体本可自行查阅的文档。
主要原则：把必要指引放在 SKILL.md 中，把有条件的细节放进 references，并说明何时读取每一项；技能命名应体现其覆盖的流程或主题，描述要说明它做什么、何时调用；保持每个技能聚焦，把不相关的触发条件或决策拆成独立技能；用对比示例配简短说明来展示差异，并解释差异为何重要；文字直接、格式一致。
脚本与依赖：确定性工作用脚本，需要判断的部分交给模型；优先使用现有工具和标准库；第三方 Python 依赖用 PEP 723 声明，并用 uv 锁定；脚本应可复现，并能在只读安装环境下使用。
可移植性：指引应能在源项目之外使用，示例要符合所用框架；资源保持可移植并归属其所属技能；资源路径保持扁平，与入口点仅一跳；引用外部库时不要复制其文档；打包资源前先检查分发与许可规则。
限制：资料未提供具体示例代码、版本要求、安装步骤或适用平台信息。