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?
  • 示例是否真实?
  • 脚本是否可选且可检查?
  • 危险操作是否有说明?

下一步