mush-skills

Claude Code skills for RhostMUSH softcode development. Covers the full lifecycle: scaffold → build → test → lint → review → publish → deploy → rollback.

37 skills. Works with rhost-template.

---

Install

git clone https://github.com/lcanady/mush-skills ~/.claude/skills/mush-skills-repo
cd ~/.claude/skills/mush-skills-repo
./install.sh

Then restart Claude Code.

Options

./install.sh                  # install all 37 skills (symlinked)
./install.sh --copy           # hard-copy instead of symlink
./install.sh mush-build       # install one skill
./install.sh --check          # report installed / outdated / missing
./install.sh --uninstall      # remove all mush-* skills

Update

cd ~/.claude/skills/mush-skills-repo
git pull
./install.sh                  # re-links — symlinks auto-update, copies re-copy

---

Usage

Every session should start with /mush-session to sync the corpus and load the project manifest. Then use any skill by name:

/mush-session
/mush-build chargen stat system
/mush-test
/mush-lint
/mush-review

/mush-architect is the master orchestrator — it auto-routes to the right sub-skill based on your prompt.

---

Skill Reference

Skill	Description
/mush-architect	Master orchestrator for all RhostMUSH softcode work. Auto-activates when the user mentions MUSH, softcode, mushcode, RhostMUSH, PennMUSH, TinyMUX, builders, wizards, @create, &attributes, or any MUSH game development topic. Routes to the right sub-skill or chains multiple skills together.
/mush-audit	Compare live server state against dist/manifest.json. Finds orphaned attributes, missing objects, version drift, and objects on the server not tracked in the manifest.
/mush-bboard	Scaffold a RhostMUSH bulletin board system — post/read/reply, group subscriptions, admin moderation, and notification hooks.
/mush-build	Write RhostMUSH softcode — commands, UDFs, and systems. Use when the user wants to build, write, create, or code a MUSH system, feature, command, or function.
/mush-chargen	Scaffold a RhostMUSH character generation system — stat arrays, sheet display, approval workflow, staff review commands, and approval locks.
/mush-config	Read, set, and persistently save RhostMUSH server config parameters using @admin and the admin_object pattern. Use when tuning server limits, enabling features, or managing rhost_ingame.conf.
/mush-coverage	Find which attributes have no @rhost/testkit test. Produces a gap report sorted by risk level — untested commands are higher risk than untested config attrs.
/mush-deps	Map dependencies between softcode attributes and objects. Shows what calls what, what would break if removed, and cross-object coupling. Use before refactoring or removing code.
/mush-docs	Generate help text and documentation for RhostMUSH softcode. Use when writing help, docs, or documentation for commands and UDFs.
/mush-efficiency	Optimize RhostMUSH softcode for speed, attribute count, and server load. Use when softcode is slow, laggy, or needs performance improvements.
/mush-explain	Explain what RhostMUSH softcode does. Use when the user asks 'what does this do', 'explain', 'how does this work', or wants code walked through.
/mush-export	Pull existing softcode off a live RhostMUSH server into local src/ files. Use when inheriting a codebase, backing up live code, or reverse-engineering an installed system.
/mush-format	Format and compress RhostMUSH softcode. Expands compressed .txt installers to human-readable .mush source, and compresses pretty .mush source to single-line .txt installers.
/mush-hook	Build and manage RhostMUSH @hook systems — before/after/permit/ignore/fail hooks on commands and attributes stored on the hook_obj.
/mush-hooks	Configure Claude Code settings.json hooks to automatically enforce mush-lint and mush-test gates on every softcode edit.
/mush-init	Scaffold a new RhostMUSH project: directory structure, manifest, package.json, and starter files.
/mush-install	Deploy RhostMUSH softcode to a live server.
/mush-jobs	Scaffold a RhostMUSH job/request tracking system — players submit requests, staff claim and resolve them, with queuing, priority, and notification.
/mush-learn	Extract reusable patterns from completed softcode work and contribute them to the mush-patterns corpus.
/mush-lint	Static analysis for RhostMUSH softcode and installer files. Use before packaging to catch unsafe patterns, missing guards, and formatting violations.
/mush-manifest	Create and maintain dist/manifest.json tracking all objects, dbrefs, and attribute checksums.
/mush-migrate	Port RhostMUSH softcode between server flavors — TinyMUX, PennMUSH, TinyMUSH, RhostMUSH.
/mush-monitor	Monitor a live RhostMUSH server — connectivity, queue depth, player count, memory, error log, attribute health. Read-only.
/mush-natural	Translate natural-language feature descriptions into RhostMUSH softcode.
/mush-patch	Generate a minimal patch installer containing only changed attributes since the last version.
/mush-publish	Package mushcode and open a PR into the public mush-softcode community repo.
/mush-readme	Generate or update a README.md for a RhostMUSH softcode project.
/mush-release	Full release workflow: bump version, update installer header, generate patch installer, write changelog, create git tag, push.
/mush-review	Senior code review for RhostMUSH softcode — logic, idioms, design patterns, and architecture.
/mush-rollback	Generate and execute a rollback installer to remove a deployed system from a live server.
/mush-security	Audit RhostMUSH softcode for injection, privilege escalation, and security issues.
/mush-session	Initialize a session: sync corpus, load manifest, detect server config. Run this first every session.
/mush-simulate	Trace RhostMUSH softcode execution without a live server — follow call chains, predict output, detect recursion.
/mush-test	Write or run @rhost/testkit tests for RhostMUSH softcode.
/mush-troubleshoot	Debug failing or misbehaving RhostMUSH softcode.
/mush-upgrade	Upgrade a deployed system from one version to another — diff manifest, generate migration patch, apply, verify.
/mush-watch	Watch src/ for changes and auto-rebuild the installer with lint on every save.

---

Works With

• rhost-template — project template with compiler, Docker test runner, and mush.json package registry
• @rhost/testkit — RhostMUSH Docker test harness
• mush-patterns — reusable softcode pattern corpus used by /mush-session

---

License

MIT