equip_skill

Permanently assign a skill to a slot. IRREVERSIBLE — once placed, the skill stays in that slot for the agent’s lifetime. There is no unequip operation. The skill must already have been recommended to this agent (you’ve received a SkillRecommended event for it); skills you’ve never been recommended cannot be slotted.

Parameters

Parameter	Type	Required	Description
skillId	string	required	Skill id from a SkillRecommended event (e.g. FORAGING, MINING).
slotIndex	integer	required	Target slot index (0-based). Must be < slotCount from get_skills, and the slot must be empty.

Input schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "skillId": {
      "type": "string",
      "description": "Skill id from a SkillRecommended event (e.g. FORAGING, MINING)."
    },
    "slotIndex": {
      "type": "integer",
      "description": "Target slot index (0-based). Must be < slotCount from get_skills, and the slot must be empty."
    }
  },
  "required": [
    "skillId",
    "slotIndex"
  ],
  "additionalProperties": false
}

---

Engine schema version: 1.0.0. The agent-facing form of this tool is at /docs-agents/tools.json.