Appearance
Kiro Skills 是遵循开放 Agent Skills 标准的可移植指令包，将使用说明、脚本与模板打包成可复用单元。Kiro 启动时只加载每个 skill 的名称与描述，仅在请求匹配时才加载完整指令，实现按需激活。Skills 分为工作区级别（.kiro/skills/）和全局级别（~/.kiro/skills/），支持从 GitHub 或本地目录导入，也可通过 / 斜杠命令手动触发，适合团队共享标准化工作流。
什么是 Skills？
Skills 是遵循开放 Agent Skills 标准的可移植指令包。它们将使用说明、脚本和模板打包成可复用单元，Kiro 在合适的时机自动激活。
由于 Skills 遵循开放标准，你可以从社区导入 Skills，也可以将自己的 Skills 分享给其他兼容 AI 工具。
Skills 的工作原理
AI 智能体能力越来越强，但往往缺乏完成真实工作所需的具体上下文。如果把所有背景信息一次性加载，会导致上下文过大，响应变慢、质量下降。
Skills 通过渐进式加载解决这个问题：
- 发现：Kiro 启动时只加载每个 skill 的名称和描述
- 激活：当请求与某个 skill 的描述匹配时，Kiro 加载完整指令
- 执行：Kiro 按指令执行，仅在需要时加载脚本或参考文件
这样既保持上下文精简，又能在需要时按需获取专项知识。
使用 Skills
Kiro 会在请求匹配时自动激活 Skills。你也可以在聊天输入框中输入 / 查看可用 Skills 列表，直接选择斜杠命令来显式激活。
在 Kiro 面板的 Agent Steering & Skills 部分可以查看和管理 Skills。
Skill 的作用范围
Skills 分为工作区范围和全局范围。
工作区 Skills
存放在项目的 .kiro/skills/ 目录下，仅对当前工作区生效。适合存放特定项目的工作流，如部署流程或团队规范。
全局 Skills
存放在用户主目录的 ~/.kiro/skills/ 下，对所有工作区可用。适合存放个人通用工作流，如代码审查流程或文档规范。
当全局 Skills 与工作区 Skills 名称冲突时，Kiro 优先使用工作区 Skills，从而允许在特定项目中覆盖全局设置。
导入 Skills
- 打开 Kiro 面板中的 Agent Steering & Skills 部分
- 点击
+，选择 Import a skill - 选择来源：
- GitHub：粘贴指向 skill 文件夹或
SKILL.md文件的公开仓库 URL（必须指向子目录，不能是仓库根目录） - 本地文件夹：从本地文件系统导入
- GitHub：粘贴指向 skill 文件夹或
导入的 Skills 会被复制到 Skills 目录并立即生效。
创建 Skill
一个 Skill 就是一个包含 SKILL.md 文件的文件夹：
my-skill/
├── SKILL.md # 必须
├── scripts/ # 可选：可执行脚本
├── references/ # 可选：参考文档
└── assets/ # 可选：模板文件SKILL.md 格式
---
name: pr-review
description: Review pull requests for code quality, security issues, and test coverage. Use when reviewing PRs or preparing code for review.
---
## Review process
1. Check for security vulnerabilities
2. Verify error handling
3. Confirm test coverage
4. Review naming and structureFrontmatter 字段说明
| 字段 | 是否必填 | 说明 |
|---|---|---|
| name | 是 | 必须与文件夹名称一致，只允许小写字母、数字和连字符（最多 64 个字符） |
| description | 是 | 描述该 Skill 的使用场景，Kiro 依此匹配请求（最多 1024 个字符） |
| license | 否 | 许可证名称或对内置许可证文件的引用 |
| compatibility | 否 | 环境要求（如所需工具、网络访问） |
| metadata | 否 | 附加键值数据，如作者或版本号 |
详细字段约束请参阅 完整规范。
Skills 与 steering、Powers 的区别
Skills 是遵循开放标准的可移植包，按需加载，可包含脚本，适合可共享或可导入的可复用工作流。
Steering 是 Kiro 专属的上下文，用于塑造智能体行为，支持 always、auto、fileMatch 和 manual 模式，适合项目规范和约定。
Powers 将 MCP 工具与知识和工作流打包在一起，根据上下文动态激活，适合需要工具与指导并用的集成场景。
最佳实践
精准的描述：Kiro 依靠 description 决定何时激活，加入具体关键词。例如，"Review pull requests for security and test coverage"优于"helps with code review"。
SKILL.md 保持精简：详细文档放在 references/ 目录中，SKILL.md 在激活时会被完整加载。
用脚本处理确定性任务：校验、文件生成、API 调用等任务用脚本实现比让 LLM 生成代码更可靠。
选择合适的范围：个人工作流用全局 Skills（如你的代码审查清单），团队流程用工作区 Skills（如项目部署步骤）。
相关文档
- Steering — 项目专属上下文与标准
- Agent Skills 规范 — 完整格式说明
常见问题
Q：Skill 会自动激活，但我不想让它在某次对话中生效，怎么办？
Skills 采用描述匹配激活。如果你不希望某个 Skill 介入，可以在提问时避免使用触发关键词，或者通过 Kiro 面板临时禁用该 Skill。
Q：全局 Skill 和工作区 Skill 同名时，哪个优先？
工作区 Skill 优先级更高。这让你可以在全局定义通用规范，同时针对特定项目进行覆盖，互不干扰。
Q：SKILL.md 中的 references/ 目录有什么用？
references/ 中的文件不会在 Skill 激活时自动加载，只有在 Kiro 执行具体步骤时按需引用。这样可以让 SKILL.md 本身保持精简，同时允许附带大量参考资料。