Skills（技能）

Skill 是包含领域指令的 Markdown 文件。激活后，其内容会注入到 LLM 上下文中，让代理在特定场景下具备稳定、可复用的专业能力。

IronClaw 支持从 ClawHub 社区注册表搜索和安装技能。

Skill 能做什么

一个 Skill 通常定义四件事：

每轮对话都会评估技能，选出相关且预算内的技能注入后再进行推理。

Gate（门控）

先检查前置条件：PATH 中是否有要求的二进制、环境变量是否存在、配置是否齐全。未通过门控的技能直接跳过。

Score（打分）

对通过门控的技能按关键词、标签、正则命中进行确定性打分。

Budget（预算）

按分数从高到低选择技能，直到耗尽 SKILLS_MAX_TOKENS。

Attenuate（收敛）

按信任级别施加工具上限：安装技能默认降级为只读工具；受信任技能保留完整能力。

级别	来源	工具权限
Trusted	`~/.ironclaw/skills/` 或工作区 `skills/`	与代理一致的完整权限
Installed	通过 `skill_install` 从 ClawHub 安装	只读工具（无 shell、无文件写入、无 HTTP）

不要把未经审查的 Skill 放到受信任目录。受信任 Skill 与你拥有相同级别的执行能力。

当 SKILLS_AUTO_DISCOVER=true（默认）时，启动阶段会扫描所有技能目录并索引合法的 SKILL.md。运行中新增技能一般在下次重启后生效。

# 自动发现（默认 true）
SKILLS_AUTO_DISCOVER=true

# 每轮技能注入总预算
SKILLS_MAX_TOKENS=4000