action-messages

Compose perspective-aware action messages for interactive narratives and MUD-style gameplay using token-based grammar adaptation.

8|3|Updated Sep 29, 2021
One-click install
npx skills add https://github.com/gesslar/oxidus-mudlib --skill action-messages
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: action-messages
Source: https://github.com/gesslar/oxidus-mudlib/tree/main/.claude/skills/action-messages
Command: npx skills add https://github.com/gesslar/oxidus-mudlib --skill action-messages

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Understand and write action messages that adapt to the actor, target, and room perspectives, preserving correct pronouns and conjugations across contexts.

Core Features & Use Cases

  • Perspective-aware message composition using tokens like $N, $v, $t, $o, $p, $r, and $b for actor, target, and audience.
  • Supports action functions (simple_action, my_action, other_action, targetted_action, target_action, my_target_action) and reflexive handling.
  • Handles articles, pronouns, plurality, and common pitfalls to ensure natural, grammatically correct narration for MUD-like environments.

Quick Start

Provide a sample action template like "$N $vswing $p sword." to demonstrate actor and audience perspectives.

Frequently Asked Questions about action-messages

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I generate MUD action messages that adapt grammar for different perspectives?

MUD action messages can adapt grammar by using perspective-aware tokens like $N, $v, and $t to automatically adjust pronouns and verb conjugations for the actor, target, and room observers. This ensures natural narration across all viewpoints without manual string duplication.

What are action message tokens and how do they handle verb conjugation?

Action message tokens like $v for verbs and $p for pronouns dynamically conjugate and substitute text based on the subject reading the message. They resolve plurality and gender automatically so that a single template produces grammatically correct output for every perspective.

How do I compose targetted actions that display differently to the actor and the target?

Targetted actions use specific action functions like targetted_action and my_target_action to render distinct messages for the actor, the target, and room observers. Tokens such as $o and $r handle object references and reflexives so each perspective sees appropriate grammar.

Can I use action message templates for interactive narratives outside of MUDs?

Yes, action message templates work for any interactive narrative requiring context-aware narration. The token-based system handles articles, pronouns, and verb conjugations dynamically, making it suitable for any text-based game or story environment where actions must be rendered from multiple perspectives.

Why do my action message templates output incorrect pronouns and articles for room observers?

Incorrect pronouns and articles typically occur when templates omit reflexive tokens like $r or fail to account for plurality. Using the correct action function and applying the full set of perspective-aware tokens ensures proper article handling and grammar across actor, target, and observer contexts.

What is the best way to handle reflexive actions in text game narration?

Reflexive actions in text game narration are handled using the $r token alongside appropriate action functions like my_action. This automatically resolves reflexive pronouns so that actions performed on oneself read naturally without requiring separate template strings for each perspective.