Skills文件组织结构基本样例（仅作参考）

skill-sample/
├─ SKILL.md              ⭐ 必备：技能说明入口：用途 / 安装 / 用法 / 示例 / 依赖
├─ manifest.sample.json  ⭐ 推荐：机器可读元信息：用于索引 / 校验 / 自动填表
├─ LICENSE.sample        ⭐ 推荐：授权与使用范围：开源 / 限制 / 商用说明
├─ scripts/
│  └─ example-run.py     ✅ 可运行示例脚本：让用户导入后立刻验证“能用”
├─ assets/
│  ├─ example-formatting-guide.md  🧩 输出规范：统一排版 / 结构 / 风格
│  └─ example-template.tex         🧩 模板资源：报告/文档模板，快速生成标准产物
└─ references/           🧩 参考资料库：方法论 / 结构指南 / 最佳实践
   ├─ example-ref-structure.md     🧩 结构参考：章节框架 / 目录组织
   ├─ example-ref-analysis.md      🧩 分析参考：常用套路 / 指标口径
   └─ example-ref-visuals.md       🧩 视觉参考：图表规范 / 可视化建议

更多 Agent Skills 规范 详见Anthropic官方文档：https://agentskills.io/home

SKILL.md 内容要求

├─ ⭐ 必备：YAML Frontmatter（必须存在，放在文件最顶部）
│  ├─ ⭐ name                 ：技能唯一名；须符合命名规则，并建议与目录名一致
│  └─ ⭐ description          ：技能描述；建议包含触发关键词（便于检索/匹配）
│
├─ ✅ 可选：Frontmatter 扩展字段（规范允许，但非强制）
│  ├─ ✅ license              ：许可证标识（也可配合单独 LICENSE 文件）
│  ├─ ✅ compatibility        ：兼容性/运行环境要求（仅在确实有限制时写）
│  ├─ ✅ metadata             ：任意键值对（如 author/version/source_url 等）
│  └─ 🧩 allowed-tools        ：允许工具白名单（规范标注为 experimental）
│
└─ ✅ 推荐：Markdown 正文（自由格式，但建议按“渐进式披露”组织）
   ├─ ✅ Overview / Purpose   ：一句话说明目标 + 不做什么（边界）
   ├─ ✅ When to use          ：触发条件/适用场景（让模型/用户知道何时调用）
   ├─ ✅ Step-by-step         ：步骤化流程（最好 3–6 步，保证可复现）
   ├─ ✅ Inputs / Outputs     ：输入格式、输出格式、产物位置（文件/文本/JSON等）
   ├─ ✅ Examples             ：至少 1 个可复制示例（越“能跑”越好）
   ├─ 🧩 Files & References   ：引用assets/、references/、scripts/（相对路径）
   ├─ 🧩 Edge cases           ：边界情况/限制（大文件、速率限制、失败回退）
   ├─ 🧩 Troubleshooting      ：常见错误与解决（依赖缺失、路径不对、权限问题）
   └─ 🧩 Safety notes         ：涉及联网/写文件/执行命令时给出提醒（建议写）