用途：为 Ignite UI for React 仓库提供编写或更新 SKILL.md 的规则，使智能体能够可靠地发现并加载技能。
位置：内部面向贡献者的技能放在 .agents/skills/<name>/SKILL.md；随 igniteui-react 包发布的公开技能放在 skills/<name>/SKILL.md。文件夹名必须与 name 字段一致。
Frontmatter：license 必填，须指定技能发布所用许可证，默认 MIT；name 必填，最多 64 字符，仅小写字母、数字和连字符，不得含 XML 标签或保留字（anthropic、claude），公开技能使用 igniteui-react- 前缀，内部技能使用普通 kebab-case 名称；description 必填且非空，最多 1,024 字符，不得含 XML 标签，用第三人称写明技能覆盖内容，并同时包含 WHEN TO USE（应加载该技能的任务或触发条件）与 WHEN NOT TO USE（不覆盖的邻近任务，并指明应改用哪个技能）。智能体在加载前只能看到 name 和 description，因此 description 决定技能是否被使用。可选键包括 user-invocable、argument-hint、compatibility、disable-model-invocation、metadata。
Token 预算：SKILL.md 正文保持在 500 行以内；超出时采用渐进式披露，将概览和核心规则留在 SKILL.md，细节移入 references/<topic>.md，并从 SKILL.md 直接链接每个引用文件（仅一层深），说明何时阅读，以便按需加载。
公开技能：发布流水线会把 skills/ 复制进已发布的 igniteui-react 包，用户也会把单个技能文件夹复制到自己的智能体目录。因此 skills/ 下的技能应保持相对链接位于 skills/ 内，指向技能自身的 references/ 文件或同级技能 ../<name>/SKILL.md；仓库内其他内容用绝对 GitHub URL 链接。重命名公开技能或移动其文件对已安装用户属于破坏性变更，须在 CHANGELOG.md 中说明；公开技能的所有用户可见变更记录在 CHANGELOG.md 的 ## Unreleased 下。
检查清单：frontmatter 通过上述规则；description 含 WHEN TO USE: 与 WHEN NOT TO USE:；正文少于 500 行且每个引用文件都从 SKILL.md 链接；技能列入其 README 的 Skills 表（内部技能为 .agents/skills/README.md，公开技能为 skills/README.md 及根 README.md 的 AI-Assisted Development 表），内部技能还列入 .agents/context/project.md 的 Workflow 部分；仅公开技能需确保每个相对链接在 skills/ 内可解析，且 CHANGELOG.md 有条目。