home / skills / bdambrosio / cognitive_workbench / mc-inventory

mc-inventory skill

safe

This skill inspects Minecraft inventory state, returning all slots and equipped items in both human-readable text and machine-readable data.

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

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

Files (2)

Skill.md

1.2 KB

---
name: mc-inventory
type: python
description: "Observe inventory contents and equipped items - epistemic, read-only. Returns inventory slots and equipped items"
situational: true
---

# Minecraft Inventory Tool

Observes inventory contents and equipped items. Read-only epistemic tool for checking current inventory state.

## Purpose

Inventory inspection for planning and decision-making. Returns both human-readable inventory text and machine-readable structured data including all slots and equipped items.

## Input

- `value`: Ignored

## Output

Returns uniform_return format with:
- `value`: Multi-line inventory text (human-readable)
- `data`: Structured inventory dict (machine-readable). Key fields:
  - `success`: Boolean
  - `slots`: Array of `{slot: int, item: string, count: int}`
  - `equipped`: `{hand: string, offhand: string}`

## Behavior & Performance

- Read-only: Does not modify inventory
- Fast status check
- Returns complete inventory state including empty slots

## Guidelines

- Use before planning item operations (equip, drop, craft)
- Check `equipped.hand` and `equipped.offhand` for currently held items
- Empty slots have `item: null` or empty string

## Usage Examples

Check inventory:
```json
{"type":"mc-inventory","out":"$inv"}
```

Overview

This skill inspects a Minecraft player's inventory and equipped items in a read-only, epistemic way. It returns both a human-readable multi-line inventory text and a machine-readable structured object describing every slot and what is equipped. Use it to quickly learn current item state without modifying anything.

How this skill works

When invoked, it queries the current inventory and produces a uniform_return containing a textual listing and a structured dict. The structured output includes success, an array of slots with slot index, item name, and count, plus an equipped object with hand and offhand. Empty slots are explicitly represented as null or empty strings so callers can plan deterministically.

When to use it

Before planning actions that depend on items (equip, craft, drop, use).
When you need a fast snapshot of all inventory slots and counts.
To verify what is currently in the main hand and offhand.
Before automated item management or sorting routines.
When debugging inventory-related agent decisions or scripts.

Best practices

Treat the output as read-only and do not assume inventory changes after retrieval.
Check equipped.hand and equipped.offhand first for immediate held items.
Handle empty slots explicitly (item null or empty string) in your logic.
Use the slot index values for precise item transfers or targeted operations.
Re-query the skill after any action that might change inventory to avoid stale data.

Example use cases

Confirming you have the right tools and weapons before entering combat.
Creating a craft plan by listing available materials and their counts.
Automated systems deciding whether to pick up or discard items based on current inventory.
Verifying that a specific item is equipped in the main hand before performing an action.
Inventory auditing for bots that must maintain minimum supplies (food, torches, blocks).

FAQ

Does this skill modify the inventory?

No. It is strictly read-only and only reports current state.

How are empty slots represented?

Empty slots appear with item set to null or an empty string and count typically zero.