问题定义
前两章我们理解了 Skill 是什么、为什么有用。从本章开始，我们要动手了。但在写下第一个字符之前，必须先搞清楚SKILL.md的格式规范。
很多新手写 Skill 时容易犯这些错误：
name字段用了大写字母或下划线；description写得太笼统，Agent 根本不知道怎么触发；- 目录名和
name不一致，导致 Agent 加载失败； - 把所有内容都塞进
SKILL.md，结果文件又臭又长； - 引用
references/里的文件时用了绝对路径或深层嵌套。
本章的目标就是帮你掌握 Qoder Skill 的规范，写出结构清晰、格式正确、易于维护的SKILL.md。
核心概念
Qoder Skill 的目录结构
Qoder 采用与 Agent Skills 开放标准一致的目录结构。一个 Skill 目录通常长这样：
.qoder/skills/<skill-name>/ ├── SKILL.md # 必需：元数据 + 指令 ├── references/ # 可选：参考文档、规范、检查清单 ├── assets/ #