Skip to main content
Generaldvcrn

mud

Operate and maintain the persistent MUD agent for OpenClaw. Use when running MUD engine commands, smoke-testing mud state behavior, validating save/restore, diagnosing MUD data issues, or handling MUD deployment operations.

Stars
15
Source
dvcrn/openclaw-skills-marketplace
Updated
2026-05-29
Slug
dvcrn--openclaw-skills-marketplace--mud
View on GitHubRaw SKILL.md

// install — copy + paste into any project

mkdir -p .claude/skills && curl -fsSL https://raw.githubusercontent.com/dvcrn/openclaw-skills-marketplace/HEAD/plugins/andrew-goetz-com--mud/skills/mud/SKILL.md -o .claude/skills/mud.md

Drops the SKILL.md into .claude/skills/mud.md. Works with Claude Code, Cursor, and any agent that loads SKILL.md files from .claude/skills/.

MUD

Authors: agigui and lia

Use this skill to run the local MUD engine safely and deterministically.

Workflow

  1. Locate the engine directory.
    • Prefer C:\Users\openclaw\.openclaw\workspace-mud-dm\mud-agent
    • Fallback: C:\Users\openclaw\.openclaw\workspace\mud-agent
  2. Run a smoke test with scripts/mud_cmd.py.
  3. Run requested MUD operations.
  4. Use references/ops.md and references/commands.md for runbook details.

Command runner

python skills/mud/scripts/mud_cmd.py "<command>"

Examples (current CLI engine):

python skills/mud/scripts/mud_cmd.py "list-races"
python skills/mud/scripts/mud_cmd.py "register-player --campaign demo --player u1 --name Hero"
python skills/mud/scripts/mud_cmd.py "new-character --campaign demo --player u1 --name Rook --race human --char-class rogue"
python skills/mud/scripts/mud_cmd.py "save --campaign demo"
python skills/mud/scripts/mud_cmd.py "check-image-cooldown --campaign demo"
python skills/mud/scripts/mud_cmd.py "generate-image --campaign demo --prompt \"A rain-soaked neon tavern\""

Legacy slash-command engine is auto-detected and still supported by the same wrapper.

Notes

  • Keep mechanics deterministic in engine code; use LLM for narration.
  • Avoid hardcoded secrets/tokens in skill files.
  • Image generation is available through engine commands (check-image-cooldown, record-image, generate-image) when the runtime image pipeline is configured.
  • Keep this skill focused on operations and execution.