Fineuralab
Claude Code Skill 结构
常见 Claude Code Skill 结构指南:SKILL.md、references、scripts、assets 和渐进式加载。
AI Skills 专题
Claude Code Skill 结构
实用 Skill 仓库通常会让 agent 先读最小有用说明,只有任务需要时才打开更深材料。
主要组成
有用的 Skill 包会把触发说明、深入参考和可重复脚本分开。
- SKILL.md 放触发和核心行为。
- references/ 放深入规则和示例。
- scripts/ 放机械可重复步骤。
- assets/ 放模板、图片或样例文件。
为什么要渐进式加载
一次加载所有内容会让 agent 更慢也更不可预测。好的 Skill 会说明什么时候打开什么。
- 首次阅读短。
- 引用材料按任务加载。
- 脚本目的清晰。
- 减少无关上下文。
仓库复核
浏览 Skill 仓库时,不要只看热度,要检查结构是否匹配它承诺的用途。
- 目录结构是否匹配 README?
- 示例是否真实?
- 脚本是否可选且可检查?
- 危险操作是否有说明?