home / skills / bdambrosio / cognitive_workbench / mc-say

mc-say skill

safe

This skill sends a Minecraft chat message for social, debugging, and alignment purposes, returning an acknowledgement and machine-readable status.

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

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-say
type: python
description: "Send chat message in Minecraft - social/debugging/alignment. Returns acknowledgement only"
---

# Minecraft Say Tool

Sends chat message in Minecraft. Social, debugging, and alignment tool for communication.

## Purpose

Chat communication for social interaction, debugging output, and alignment with human observers. Sends text messages visible in Minecraft chat.

## Input

- `value`: Message text (preferred)
- `message`: Message text (alternative to value)

## Output

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

## Behavior & Performance

- Sends message to Minecraft chat
- Message visible to all players and observers
- Returns immediately after sending

## Guidelines

- Use for debugging and status reporting
- Use for social interaction with other players
- Use for alignment and transparency with human observers
- Messages are public and visible to all

## Usage Examples

Send chat message:
```json
{"type":"mc-say","value":"Hello!","out":"$ack"}
```

Send debug message:
```json
{"type":"mc-say","message":"Debug message","out":"$ack"}
```

Overview

This skill sends a chat message into a running Minecraft instance for social, debugging, or alignment purposes. It posts text to the public Minecraft chat visible to all players and observers. After sending, it returns a compact acknowledgement with a success flag and short summary.

How this skill works

Provide the message as the value or message field and the skill injects that text into the server/client chat stream. The skill returns immediately with a machine-readable response containing value (acknowledgement) and data.success (boolean). Messages are broadcast to all connected players and observers.

When to use it

Announce status updates or task progress to onlookers
Post debugging information or runtime traces for live troubleshooting
Signal alignment or transparency messages to human supervisors
Send short social chat messages or prompts to players
Confirm automated actions or events in the game world

Best practices

Keep messages concise and readable in chat; avoid very long blocks of text
Use this for short, public status or debug signals rather than sensitive info
Include a clear prefix or tag for automated messages so players can distinguish them
Rate-limit messages to avoid chat spam and respect player experience
Validate or sanitize message content to prevent accidental command injection

Example use cases

Send a brief status: "Backup complete" after saving world state
Post a debug trace: "Entity spawn failure at x:100 z:200" for live debugging
Broadcast an alignment note: "Agent performing maintenance, pausing actions" to inform observers
Announce in-game events or milestones to players during tests
Confirm automated action: "Chest emptied by bot" for auditability

FAQ

What inputs does the skill accept?

Provide the message using the value field or the alternative message field.

What does the skill return?

It returns an acknowledgement value and a data object with data.success set to true or false.

Are messages private or public?

Messages are public and visible to all connected players and observers; do not send secrets.