home / skills / bdambrosio / cognitive_workbench / mc-equip

mc-equip skill

safe

/src/world-tools/minecraft/mc-equip

This skill equips an item from your inventory into your hand or offhand, ensuring quick access for combat or tool use.

npx playbooks add skill bdambrosio/cognitive_workbench --skill mc-equip

Review the files below or copy the command above to add this skill to your agents.

Files (2)

Skill.md

1.4 KB

---
name: mc-equip
type: python
description: "Equip an item from inventory into hand or offhand. Returns success/failure"
---

# Minecraft Equip Tool

Equips an item from inventory into hand or offhand slot. Returns success/failure status.

## Purpose

Item equipping for tool use, combat, and interaction. Moves items from inventory slots to hand or offhand for use.

## Input

- `value`: Item name to equip (preferred)
- `item`: Item name to equip (alternative to value)
- `slot`: `"hand"` | `"offhand"` (default: `"hand"`)

## Output

Returns uniform_return format with:
- `value`: Text summary (e.g., "Equipped stone in hand")
- `data`: Structured data dict (machine-readable). Key fields:
  - `success`: Boolean
  - `equipped`: String (item that was equipped)
  - `slot`: String (`"hand"` | `"offhand"`)

## Behavior & Performance

- Requires item to be in inventory
- Fails if item not found in inventory
- Hand slot is default if slot not specified

## Guidelines

- Use `mc-inventory` first to check available items
- Item name must match exactly (e.g., "stone", "wooden_pickaxe")
- Hand slot is primary interaction slot
- Offhand slot is secondary slot (e.g., shield, torch)

## Usage Examples

Equip item in hand:
```json
{"type":"mc-equip","item":"stone","slot":"hand","out":"$equip"}
```

Equip tool:
```json
{"type":"mc-equip","value":"wooden_pickaxe","slot":"hand","out":"$tool"}
```

Overview

This skill equips an item from the player inventory into the hand or offhand slot and returns a clear success/failure result. It is designed for quick tool switching, combat readiness, and interaction workflows. The skill reports both a human-readable summary and machine-readable structured data.

How this skill works

The skill searches the player inventory for an exact item name and moves the item into the requested slot (hand by default, or offhand). It returns a uniform structure containing success (boolean), the equipped item name, the target slot, and a short text summary. If the item is not found or cannot be moved, the skill returns success=false and indicates the failure reason.

When to use it

Switch to a specific tool before performing a task (e.g., equip pickaxe before mining).
Prepare for combat by equipping a weapon in hand and a shield in offhand.
Place utility items in offhand (e.g., torch, map) for quick use while exploring.
Automate inventory-to-slot moves in scripts or macros.
Validate that required items are available before starting an action sequence.

Best practices

Always call mc-inventory first to confirm the item name and availability.
Use exact item names (e.g., "stone", "wooden_pickaxe") to avoid mismatches.
Default to the hand slot when not specified; explicitly set slot when equipping offhand items like shields.
Handle the returned structured data programmatically: check success before proceeding.
Keep equip actions idempotent in automation: avoid repeated equips if the item is already in the target slot.

Example use cases

Equip a wooden_pickaxe to hand before a mining routine.
Move a shield to offhand when entering a combat segment.
Equip a torch to offhand for cave exploration and then switch back to a tool in hand.
Scripted workflows that require guaranteed items in specific slots before executing actions.
UI automation that shows live feedback based on equip success/failure.

FAQ

What input fields does the skill accept?

Provide item name via value or item, and optional slot set to "hand" or "offhand" (default is "hand").

What does the skill return?

It returns a text summary and structured data including success (boolean), equipped (item name), and slot ("hand" or "offhand").