创建 Skill 与资源目录

可以直接请 Gemini 使用内置 skill-creator 创建目录，也可以手工编写。最小必需文件是 SKILL.md；脚本、参考和模板仅在任务需要时添加。

推荐目录

.gemini/skills/code-reviewer/
├── SKILL.md
├── scripts/
├── references/
└── assets/

scripts 放确定性逻辑，references 放较长参考，assets 放模板或其他非执行资源。激活后 Agent 能读取整个 Skill 目录，因此不要在其中夹带与任务无关的秘密。

元数据与指令

以下为按官方格式整理的最小定义，保存为 SKILL.md：

---
name: code-reviewer
description: Review code changes for correctness and maintainability. Use when the user asks for a code review.
---

# Review procedure

1. Read the requested changes and relevant surrounding code.
2. Identify actionable correctness issues and explain their impact.
3. Separate verified issues from questions that need more evidence.

name 与 description 必须出现在最开头的 YAML frontmatter。目录名建议与 name 一致，但发现显示名以 name 字段为准。正文写具体流程，描述写何时使用，避免把所有参考材料都堆入描述。

脚本不能只是成功提示

官方创建教程中的 review.js 标注为 mock，仅延时后打印成功；它不真的审核文件。采用示例时要实现实际读取、校验和失败退出，不能把输出 Success 当成完成代码检查的证据。

如果正文要求执行脚本，资源目录中必须有对应实现，并说明输入、输出和适用范围。

验证与打包脚本

官方说明核心包内有以下开发脚本：

node scripts/init_skill.cjs <name> --path <dir>
node scripts/validate_skill.cjs <path/to/skill>
node scripts/package_skill.cjs <path/to/skill>

这些是核心包相对路径，不是保证在任意项目根可运行的全局命令；先定位对应脚本。package 生成 .skill zip 包。日常本地开发可使用 gemini skills link . 链接当前 Skill 目录。

验证实际触发

重载后确认列表出现正确名称，再给出匹配描述的任务，检查激活来源、目录和实际步骤。仅看到 Skill 名称不证明脚本有效，仍需检查它处理失败输入时的行为。