技能

技能为任务增加可复用指令、脚本、参考资料和资源。只有包含真实领域知识或可重复工作流时才应创建技能。 技能可以收窄工作方法，但不能扩大任务权限、工作区或可用工具。

内置技能

Kairo Code 包含用于交互解释的 visualize 和从描述创建可安装视觉伙伴的 hatch-pet；具体可用项取决于 版本和组织政策，以当前 Host 的技能目录为准。应用拥有的内置技能位于 <data-dir>/skills/bundled/， 会随发布刷新，不要手工修改。

在 Settings → Extensions → Skills 查看、从批准的 Git URL 安装或移除技能；在输入框为任务激活 已可用技能。安装、预览、更新和删除属于 Host 管理，只能在回环本地 Host 或桌面 SSH 到这样的远程 Host 执行。JWT、API token、配对设备、LAN 或正确配置的反向代理会话只能查看脱敏目录。Kairo 在启动 Git 前 拒绝本地路径、URL 凭据与 query/fragment 秘密载体，也不会在 API 中暴露安装路径。

用户技能

支持两种布局：

• 单文件：~/.agents/skills/my-skill.md 或 <repository>/.agents/skills/my-skill.md；
• 资源包：~/.agents/skills/my-skill/SKILL.md 或仓库中的对应路径，可带 scripts/、references/、 assets/ 等相对资源。

用户目录对该用户所有任务可见；仓库技能从 Git 根到所选任务根逐层发现，离任务根更近者优先。这些路径 不随 KAIRO_CODE_DATA_DIR 移动。解析优先级由低到高是 SYSTEM → PLUGIN → USER → ADMIN → REPO； 管理员目录默认为 /etc/kairo/skills。多根项目按声明顺序加载，后一个根的同名定义覆盖前一个。

Settings/Marketplace 安装与手工编写的用户技能共享 ~/.agents/skills 和 USER 层，没有额外“托管优先级”。 名称大小写不敏感；同一物理范围不能同时存在同名平面文件与资源包。发生规范名称冲突时该名称失败关闭， 不会依赖文件系统遍历顺序随机选择；先在本地移除或重命名冲突项再重载。

技能文件必须使用 --- 包围 YAML frontmatter，并提供非空 name。Markdown 正文是注入指令，目录描述 取正文首个非标题段的前 200 个字符；此格式不会读取 frontmatter 的 description。

---
name: my-skill
visibility: VISIBLE
disable_model_invocation: false
---

# 我的技能

说明领域约定、代码风格、术语或可重复流程。

可见性

• VISIBLE（默认）：目录可见，可由用户或智能体选择；
• USER_ONLY：目录可见，但不会自动建议给智能体；
• HIDDEN：不出现在用户目录。

让修改生效

修改用户或仓库技能后，创建新任务，或对空闲任务明确重载能力快照。运行中的任务保持启动时的准确技能 集合；文件编辑、安装或插件变化不会静默改变正在进行的工作。