# Scenario > Guided end-to-end MoM scenario creation workflow. Use when creating a new Mansions of Madness scenario from scratch. Use when this capability is needed. - Skill: `tomevault-io/scenario-2` (Agent Skill, multi-file: 2 files) - Install (CLI): `npx skillmds@latest add tomevault-io/scenario-2` - Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/scenario-2/raw - Safety review: pending (external: skill-scanner PASS, skillspector PASS) - Works with: Claude Code, Claude.ai, OpenAI Codex - Category: Productivity - Author: tomevault-io (https://skillmd.com/u/tomevault-io) - Updated: 2026-09-17 - Page: https://skillmd.com/skills/tomevault-io/scenario-2 --- # /scenario - Guided MoM Scenario Creation Create a new Mansions of Madness 2nd Edition scenario for the Valkyrie app using AI-assisted tools. ## Workflow ### Step 1: Concept Ask for a scenario concept: - Theme and setting (haunted house, mysterious town, abandoned asylum, etc.) - Target difficulty (0.0-1.0, where 0.5 is medium) - Estimated play length (minutes) - Number of investigators (2-5) - Any specific expansions required (base game only vs. Beyond the Threshold, Horrific Journeys, etc.) ### Step 2: Create Scenario Use `create_scenario` to scaffold the scenario directory. This creates the directory with default `quest.ini`, `quest.txt`, and supporting files. ### Step 3: Map Design 1. Use `suggest_tile_layout` with a style (linear, l_shape, hub_spoke) based on the concept 2. Use `search_game_content` to find appropriate tiles (e.g., "hallway", "study", "garden") 3. Use `upsert_tile` to place each tile with a `side` from the tile catalog 4. Use `get_map_ascii` to visualize the layout 5. Adjust positions with `place_tile_relative` as needed For systematic placement methodology, see `/tile-placement`. ### Step 4: Event Chain Build the event flow: 1. Create `EventStart` with `trigger=EventStart` - the scenario introduction 2. Create a setup chain: EventStart → place tiles → place tokens → remove TokenInvestigators 3. Create exploration events that reveal tiles and place tokens 4. Create encounter events for monster spawns and puzzles 5. Create finale events with `$end` operation 6. Wire events together via `event1`..`event6` fields For complex patterns like loops, branching, and dialogues, see `/event-patterns` and `/variables-and-mythos`. ### Step 5: Tokens Place tokens on the map: - `TokenExplore` - reveals new areas (place at tile boundaries) - `TokenSearch` - provides items (1 per area recommended) - `TokenInteract` - triggers story events - `TokenInvestigators` - starting position (remove after setup) - `TokenWallOutside`/`TokenWallInside` - walls and barriers ### Step 6: Monsters & Spawns Use `upsert_spawn` for each monster encounter: - Reference monsters from catalog (MonsterCultist, MonsterGhost, etc.) - Set health scaling with `uniquehealth` and `uniquehealthhero` - Use `conditions` to gate spawns on game state For custom monsters with unique behaviors, see `/custom-monsters`. ### Step 7: Items Use `upsert_item` for starting and discoverable items: - Set `starting=True` for initial loadout - Use `traits` to specify item types (weapon, lightsource, equipment, spell, common) - Use `itemname` for specific named items For advanced distribution patterns, see `/items-and-distribution`. ### Step 8: Narrative Use `set_localization` to write all text: - `quest.name` and `quest.description` for the scenario listing - `EventName.text` for event dialog - `EventName.button1` etc. for button labels - `TokenName.text` for token descriptions ### Step 9: Validate & Build 1. `validate_scenario` - fix any errors reported 2. `build_scenario` - create .valkyrie package ## Advanced Patterns These skills cover complex patterns from the scenario editor guide: - `/event-patterns` - Event loops, multi-question dialogues, silent events, token swaps, random events, variable branching - `/tile-placement` - Systematic tile placement chains, multi-entry tiles, naming conventions - `/variables-and-mythos` - Variable system, mythos scaling, random generation, hero detection - `/custom-monsters` - Custom monsters with unique activations, evade, horror - `/ui-and-puzzles` - UI elements, custom puzzles, splash screens, interactive journals - `/items-and-distribution` - Random items, unique items, starting items, inspection events ## Tips - Use `{qst:CONTINUE}` for standard continue buttons - Use `{ffg:TILE_NAME}` to reference tile display names - Use `{c:ComponentName}` to reference component names in text - Skill tests use `{strength}`, `{agility}`, `{observation}`, `{lore}`, `{influence}`, `{will}` - Standard tile spacing is 7 units - Always remove TokenInvestigators after setup to prevent it staying interactable - Run `validate_scenario` frequently during development --- > Converted and distributed by [TomeVault](https://tomevault.io/claim/thijs-hakkenberg) — claim your Tome and manage your conversions.