已读的 Gemini CLI 官方文档列出原生 Agent Skills、SKILL.md 目录发现、许可提示及技能管理功能，故判为原生支持。工作区与用户范围不同，同名条目有优先级；技能目录可含脚本且获批后可读取资源。MCP、扩展和 GEMINI.md 均不自动等于 Skill。Skills-SI 实际下载包格式、特定技能内容与许可须逐项检查；本任务未安装、运行或登录。
준비
- 电脑已安装 Node.js 与 npm，并能从终端运行 npm；官方快速入门给出 npm 安装方式，但本指南未核实最低版本。
- 联网可访问 npm、Google 服务以及 Skills-SI 的对应技能下载页。
- 实际调用需按官方流程自行完成 Google 服务认证；本任务不登录，也不要求提供密码或密钥。
- 下载前先核对作者、许可证、SKILL.md 与附带脚本；仅下载不代表已验证安全。
설치 및 사용 단계
- 01
准备环境
打开终端确认 npm 可用，并阅读本指南所列官方安装与技能文档。运行 Gemini CLI 和技能会涉及账户认证；请由你自行决定是否认证，不要在教程或技能文件中填写凭据。本指南没有检查你的系统或安装版本。
npm --version근거와 출처SKILL.md + resources작동 확인흐름/폴더 설명도이며 공식 화면이 아닙니다. - 02
从本站下载并安全检查完整包
在 Skills-SI 对应技能页面下载完整压缩包；本站具体按钮和文件路径未在官方资料中核实，不在此编造。先检查来源、作者、许可、压缩包目录和脚本内容，再解压到临时目录。保留完整技能目录及 references、scripts、assets 等随包资源，不要只复制 SKILL.md；不要运行未审查脚本。
临时目录中含 SKILL.md 的完整技能目录（实际目录名以下载内容为准）unzip <本站下载的压缩包> -d <临时目录>；随后人工检查解压内容，不运行脚本근거와 출처临时目录中含 SKILL.md 的完整技能目录（实际目录名以下载内容为准）작동 확인흐름/폴더 설명도이며 공식 화면이 아닙니다. - 03
安装 Gemini CLI 并放置技能
官方快速入门的 CLI 安装命令为 npm 全局安装。本站若提供标准技能目录 ZIP，可将实际完整技能目录放到当前项目的 .gemini/skills/<skill-name>/，这是官方文档列明的工作区发现位置；或在 CLI 内用官方链接命令指向实际目录。不要把普通 ZIP 擅自改名为 .skill。远程 Git 仓库或本地 .skill 包则可用官方安装命令。
.gemini/skills/<skill-name>/SKILL.mdnpm install -g @google/gemini-cli # 将完整技能目录放入 .gemini/skills/<skill-name>/，或进入 Gemini CLI 后运行：/skills link <实际技能目录> --scope workspace # 官方 Git 仓库或 .skill 包安装示例：gemini skills install <仓库URL或本地.skill文件> --scope workspace근거와 출처.gemini/skills/<skill-name>/SKILL.md작동 확인흐름/폴더 설명도이며 공식 화면이 아닙니다. - 04
调用并完成首个练习
在项目目录启动 gemini。按需自行完成 Google 服务认证。用虚构会议记录提出“请整理成决议、负责人和截止日期行动清单”，观察 CLI 是否识别技能并显示激活许可提示；检查许可范围后再决定是否同意。练习数据仅使用虚构内容。
.gemini/skills/<skill-name>/SKILL.mdgemini근거와 출처.gemini/skills/<skill-name>/SKILL.md작동 확인흐름/폴더 설명도이며 공식 화면이 아닙니다. - 05
验证发现与输出
在交互会话中运行 /skills list 查看已发现技能；如刚放入目录，可运行 /skills reload 后再查看。检查技能名称及描述是否出现，并核对练习输出是否含决议、负责人和截止日期。技能会否被模型匹配并非保证；启用时 CLI 会请求许可，未实际执行或验证。
.gemini/skills/<skill-name>/SKILL.mdgemini skills list --all # 在交互会话中：/skills list；需要重新扫描时：/skills reload근거와 출처.gemini/skills/<skill-name>/SKILL.md작동 확인흐름/폴더 설명도이며 공식 화면이 아닙니다. - 06
卸载技能或 CLI
通过 gemini skills uninstall 移除已安装或链接的技能；手动复制到工作区的技能则在退出会话后只删除对应的 .gemini/skills/<skill-name>/ 目录。若还要移除 Gemini CLI，可按 npm 官方方式卸载全局包。卸载前确认范围，避免误删项目其他内容。
.gemini/skills/<skill-name>/gemini skills uninstall <技能名> --scope workspace # 如技能是手动复制的，移除对应技能目录；移除CLI：npm uninstall -g @google/gemini-cli근거와 출처.gemini/skills/<skill-name>/작동 확인흐름/폴더 설명도이며 공식 화면이 아닙니다.
연습 및 검수
用完全虚构的会议记录，让技能整理决议、负责人、截止日期行动清单，并逐项核对是否忠实于输入。
- 运行 gemini skills list --all 或在会话中运行 /skills list，检查目标技能是否被发现。
- 若刚放入目录，运行 /skills reload 后重新检查。
- 使用虚构会议记录练习，并核对输出中的决议、负责人和截止日期；不以技能被发现作为输出正确的证明。
비활성화 및 삭제
- 已安装或链接的技能：运行 gemini skills uninstall <技能名> --scope workspace（全局用户安装时按实际范围使用对应范围）。
- 手动复制的技能：关闭会话后仅移除对应 .gemini/skills/<skill-name>/ 目录。
- 移除 CLI：运行 npm uninstall -g @google/gemini-cli。
문제 해결
终端提示 gemini 命令不存在。
检查 npm 全局安装是否完成及其可执行文件目录是否在 PATH 中；按官方安装页重新核对环境并重开终端，不要猜测或执行来源不明的安装脚本。
技能未出现在列表。
确认完整目录位于官方支持的用户或工作区技能位置，目录内有有效 SKILL.md；在交互会话运行 /skills reload 后再检查。
技能没有被自动触发。
根据 SKILL.md 的描述用更贴近其任务的自然语言请求，检查 /skills list；自动匹配并非保证，切勿将 MCP 配置当作技能已安装。
激活请求或技能脚本要求访问文件、执行操作。
先审查技能目录、脚本和请求的访问范围；不理解或不预期的操作选择拒绝，不要为绕过提示关闭防护。
卸载后列表仍显示技能或移除了错误版本。
确认技能是用户级、工作区级还是手动复制，并检查同名技能的优先级；移除正确范围后重新加载技能列表。
근거와 출처
- https://geminicli.com/docs/cli/skills/
官方说明 Agent Skills 的发现机制、支持的用户/工作区目录、SKILL.md 激活与资源访问许可。
- https://geminicli.com/docs/cli/using-agent-skills/
官方技能管理说明涵盖 /skills 和 gemini skills 命令、安装/卸载、范围及远程安装安全确认。
- https://geminicli.com/docs/get-started/
官方快速入门给出 npm install -g @google/gemini-cli 安装方式，并说明使用前需通过 Google 服务认证。