playbooks

home / skills / bdambrosio / cognitive_workbench / mc-unequip

mc-unequip skill

/src/world-tools/minecraft/mc-unequip

This skill clears or swaps the equipped item in hand or offhand and returns a success status.

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

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

Files (2)
Skill.md
962 B
---
name: mc-unequip
type: python
description: "Clear or swap equipped item. Returns success/failure"
---

# Minecraft Unequip Tool

Clears or swaps equipped item from hand or offhand slot. Returns success/failure status.

## Purpose

Item unequipping for inventory management and tool switching. Moves items from hand/offhand back to inventory.

## Input

- `slot`: `"hand"` | `"offhand"` (default: `"hand"`)
- `value`: Ignored

## Output

Returns uniform_return format with:
- `value`: Text summary (success/failure message)
- `data`: Structured data dict (machine-readable). Key fields:
  - `success`: Boolean

## Behavior & Performance

- Clears specified slot
- Item returns to inventory
- Fails if slot already empty

## Guidelines

- Use before equipping different items
- Hand slot is default if slot not specified
- Empty slots cannot be unequipped

## Usage Examples

Unequip hand slot:
```json
{"type":"mc-unequip","slot":"hand","out":"$unequip"}
```

Overview

This skill clears or swaps the equipped item in Minecraft from the selected hand slot and returns a clear success/failure result. It moves the item back into inventory when possible and reports whether the operation succeeded. The default target is the main hand when no slot is specified.

How this skill works

The skill inspects the specified slot ("hand" or "offhand") and attempts to remove the item there. If an item is present it moves the item into the player inventory and sets success=true in the structured output. If the slot is already empty or the inventory cannot accept the item, the operation fails and returns success=false with a brief message.

When to use it

  • Prepare to equip a different tool or weapon
  • Automate inventory management scripts
  • Clear offhand items before performing an action that requires an empty offhand
  • Run safety checks before using commands that assume an empty hand

Best practices

  • Specify "hand" or "offhand" explicitly when automation depends on a particular slot
  • Check the returned success boolean before proceeding with follow-up actions
  • Use this skill prior to equipping items to avoid inventory conflicts
  • Handle failure cases by notifying the player or retrying after freeing inventory space

Example use cases

  • Unequip main hand before equipping a different tool in an automated routine
  • Clear offhand to ensure a free slot for shields or consumables
  • Confirm unequip success in a macro before running a crafting or building sequence
  • Integrate into scripts that maintain tidy inventories for farming or combat runs

FAQ

What inputs does the skill accept?

Provide slot as "hand" or "offhand". The value field is ignored. If slot is omitted, "hand" is used.

What does the output look like?

Output uses a uniform return structure with a text summary in value and a data dictionary. data.success is a boolean indicating success or failure.

When will the skill fail?

It fails if the chosen slot is already empty or if the item cannot be moved into inventory due to space or other constraints.