narrative-design
Quest structure, branching narrative architecture, environmental storytelling, dialogue design, and narrative pacing. Use when designing quest systems, writing branching dialogue, structuring story arcs, when narrative feels disconnected from gameplay, when players skip cutscenes, when story contradicts mechanics, or when quests feel like checklists instead of journeys. Treats narrative as a GAME SYSTEM that interacts with other systems — not a layer painted on top. Deepens experience-design's brief Narrative Integration section into full quest architecture, branching patterns, player agency, and narrative health evaluation.
What this skill does
# Narrative Design **Purpose:** Tools for designing narrative as a functioning game system — quests, branching stories, dialogue, and environmental storytelling that interact with mechanics rather than sitting alongside them. Narrative is how mechanics acquire meaning. This skill treats it with the same structural rigor as combat or economy. **Position in workflow:** Narrative design interacts with nearly every other system. Use **game-vision** to establish core fantasy and pillars first. Then use this skill to design quests, story structure, and dialogue that serve those pillars. Fan out to **encounter-design** for spatial narrative, **economy-design** for reward flow, and **motivation-design** for retention psychology. --- ## When to Activate Use this skill when: - Designing quest systems, quest chains, or quest types - Structuring branching dialogue or story paths - Narrative feels disconnected from gameplay — players skip cutscenes or ignore lore - Story contradicts mechanics (ludonarrative dissonance) - Quests feel like checklists rather than journeys - Designing environmental storytelling for levels or world areas - Players can't explain what they're doing or why in fiction terms - NPC dialogue feels flat, repetitive, or inconsequential - Planning how narrative should interact with economy, progression, or combat systems - Evaluating narrative pacing relative to gameplay intensity --- ## Core Principle: Narrative as System Narrative is not a layer on top of mechanics. It is a system that interacts with other systems. ### System Interactions Quests and story interact with every major game system: | System | Interaction | Example | |--------|------------|---------| | **Economy** | Quest rewards flow through currency/item systems | Quest reward is crafting materials, not a unique item that bypasses the economy | | **Progression** | Quests grant XP, unlock abilities, gate content | Story progression unlocks gameplay progression (new area = new abilities) | | **Encounter design** | Quests create encounter context | "Defend the village" reframes the same combat encounter with stakes | | **Social systems** | Quests build NPC relationships, faction standing | Choosing a faction in a quest closes doors with the opposing faction | | **Exploration** | Quests motivate traversal, reward discovery | Investigation quests turn exploration from wandering into purpose | ### The Context Principle Story creates CONTEXT that makes mechanical actions meaningful. - Collecting 10 herbs is a checklist. - Collecting 10 herbs because the village is dying of plague gives the same mechanic emotional weight. - The mechanic is identical. The experience is transformed. Context is the cheapest way to increase perceived value of existing mechanics. Before adding new systems, ask: can narrative context make what we already have feel more meaningful? ### The Dissonance Test If the story says one thing and the mechanics reward another, players follow the mechanics and resent the story. This is non-negotiable. | Story Says | Mechanics Reward | Result | |-----------|-----------------|--------| | "Peace is the answer" | Combat XP is the fastest progression | Players kill everything and mock the pacifist theme | | "Time is running out" | No actual time pressure | Players explore leisurely and lose immersion | | "This choice matters" | Both paths lead to identical outcomes | Players feel deceived and disengage from future choices | | "You are a lone wanderer" | Optimal play requires a full party | Fantasy is broken by mechanical requirement | **Rule:** When story and mechanics conflict, either change the story or change the mechanics. Never leave the conflict and hope players won't notice. They will. Narrative is the bridge between Fiction and Mechanics in the Experience Triangle (see **experience-design**). When that bridge is broken, the triangle collapses. --- ## Quest Structure Patterns Common quest types, their strengths, and how to subvert their weaknesses: | Type | Structure | Strength | Weakness | Subversion Technique | |------|-----------|----------|----------|---------------------| | **Fetch/Gather** | Go to X, collect Y, return | Simple, teaches exploration | Repetitive, no decisions | Destination is dangerous, or the item has a moral cost | | **Escort** | Protect NPC from A to B | Creates tension, attachment | Frustrating AI, pacing loss | Give the NPC agency — they help you, not just follow | | **Investigation** | Gather clues, reach conclusion | Engages reasoning, rewards attention | Can stall if clues are missed | Multiple valid conclusions from the same evidence | | **Combat Challenge** | Defeat X enemies/boss | Tests core combat skills | Can feel arbitrary | Combat with constraints — protect something, time limit, limited resources | | **Puzzle** | Solve environmental/logical challenge | Mental engagement, "aha" moments | Can block progress permanently | Escalating hint system, multiple solution paths | | **Social/Dialogue** | Navigate conversation, build relationships | Character depth, emotional engagement | Can feel passive | Dialogue as mechanic — what you say has gameplay consequences | ### The Combination Principle The best quests combine 2-3 types. A pure fetch quest is boring. A fetch quest that requires investigation to find the item and combat to retrieve it is a journey. **Design rule:** When a quest uses only one type, it is a task. When it layers types, it becomes a story. Aim for at least two types per non-trivial quest. ### Quest Pacing Within a Chain A quest chain should vary its types across entries: ``` Quest 1: Investigation (low intensity, learn the stakes) Quest 2: Fetch + Combat (rising action, resource gathering under pressure) Quest 3: Social/Dialogue (emotional beat, key NPC relationship) Quest 4: Escort + Combat (climax, protect what you've built) Quest 5: Choice (resolution, player decides outcome) ``` Repeating the same type across a chain is the fastest way to make players lose interest. --- ## Quest as System Interaction Quests should stress multiple game systems to create depth and meaningful decisions. ### The System Touch Test For every quest, ask: which systems does this quest touch? | Systems Touched | Assessment | Example | |-----------------|------------|---------| | 1 system | Shallow — task, not quest | "Kill 10 wolves" (combat only) | | 2 systems | Adequate — functional quest | "Kill wolves threatening the farm, choose reward" (combat + economy) | | 3+ systems | Rich — memorable quest | "Track wolves to their den (exploration), fight the alpha (combat), discover they were fleeing something worse (narrative hook), choose whether to report to the farmer or the ranger (faction + economy)" | ### Reward Flow Quest rewards should flow THROUGH the economy system, not bypass it. - **Good:** Quest rewards currency, materials, or items that participate in crafting/trading - **Bad:** Quest rewards a unique sword that is simply better than anything available — this creates inflation and undermines the economy's role - **Exception:** Milestone rewards (end of major quest chains) can be unique, but should be rare enough that they don't devalue the economy loop **Principle:** If quest rewards are the best way to get everything, the economy system is dead. Rewards should supplement the economy, not replace it. ### Quest Design Checklist - [ ] Which systems does this quest touch? (Target: 2+) - [ ] Do rewards flow through the economy system? - [ ] Does the quest use more than one quest type? - [ ] Is there at least one meaningful decision? - [ ] Does the narrative context make the mechanical task feel purposeful? - [ ] Does the quest teach the player something about a game system? --- ## Branching Narrative Architecture How to structure player choice in story at a sustainable scale. | Architecture | Structure | Complexity | Replayability | Best For | |-------------|-----------|-----------|--------
Related in Design
contribute
IncludedLocal-only OSS contribution command center. Auto-refreshes the user's in-flight PR and issue state on invoke so conversations start with full context — no need to brief Claude on what's in flight. Helps the user find issues to contribute to on GitHub, builds per-repo dossiers of what each upstream expects (CLA, DCO, branch convention, AI policy, draft-first, review bots, issue templates), runs deterministic gates before any external action so AI-assisted contributions don't reach maintainers as slop. State is markdown-only: candidate files at ~/.contribute-system/candidates/, repo dossiers at ~/.contribute-system/research/, append-only event log at ~/.contribute-system/log.jsonl. No database, no cloud calls. Use when the user asks about their PRs / issues / contributions, wants to find new work to take on, claim an issue, build/refresh a repo's dossier, or draft a Design Issue or PR. Trigger with "/contribute", "what's my PR status", "find a contribution", "claim issue X", "draft a Design Issue for Y", "refresh dossier for Z".
architectural-analysis
IncludedUser-triggered deep architectural analysis of a codebase or scoped subtree across eight modes — information architecture, data flow, integration points, UI surfaces, interaction patterns, data model, control flow, and failure modes. This skill should be used when the user asks to "diagram this codebase," "map the architecture," "show the data flow," "give me an ERD," "trace control flow," "find the integration points," "verify the layout pattern," "audit the UX architecture," or any similar request whose primary deliverable is mermaid diagrams plus cited reports under docs/architecture/. Dispatches haiku/sonnet sub-agents in parallel for per-mode exploration, then verifies every citation mechanically before any node lands in a diagram. Not for one-off prose explanations of code (use code-explanation) or for high-level system design from scratch (use system-design).
mcp
IncludedModel Context Protocol (MCP) server development and tool management. Languages: Python, TypeScript. Capabilities: build MCP servers, integrate external APIs, discover/execute MCP tools, manage multi-server configs, design agent-centric tools. Actions: create, build, integrate, discover, execute, configure MCP servers/tools. Keywords: MCP, Model Context Protocol, MCP server, MCP tool, stdio transport, SSE transport, tool discovery, resource provider, prompt template, external API integration, Gemini CLI MCP, Claude MCP, agent tools, tool execution, server config. Use when: building MCP servers, integrating external APIs as MCP tools, discovering available MCP tools, executing MCP capabilities, configuring multi-server setups, designing tools for AI agents.
react-native-skia
IncludedDesign, build, debug, and optimise high-polish animated graphics in React Native or Expo using @shopify/react-native-skia, Reanimated, and Gesture Handler. Use when the user wants canvas-driven UI, shaders, paths, rich text, image filters, sprite fields, Skottie, video frames, snapshots, web CanvasKit setup, or performance tuning for custom motion-heavy elements such as loaders, hero art, cards, charts, progress indicators, particle systems, or gesture-driven surfaces. Also use when the user asks for fluid, glow, glass, blob, parallax, 60fps/120fps, or GPU-friendly animated effects in React Native, even if they do not explicitly say "Skia". Do not use for ordinary form/layout work with standard views.
plaid
IncludedProduct Led AI Development — guides founders from idea to launched product. Six capabilities: Idea (discover a product idea), Validate (pressure-test the idea against fatal flaws, problem reality, competition, and 2-week MVP feasibility), Plan (vision intake + document generation), Design (translate image references into a design.md spec), Launch (go-to-market strategy), and Build (roadmap execution). Use when someone says "PLAID", "plaid idea", "help me find an idea", "product idea", "idea from my business", "idea from my expertise", "plaid validate", "validate my idea", "pressure-test", "is this idea good", "find fatal flaws", "validate the problem", "plan a product", "define my vision", "generate a PRD", "product strategy", "plaid design", "design from image", "translate image to design", "create design.md", "extract design tokens", "plaid launch", "go-to-market", "launch plan", "GTM strategy", "launch playbook", "plaid build", "build the app", "start building", or "execute the roadmap".
nextjs-framer-motion-animations
IncludedAdds production-safe Motion for React or Framer Motion animations to Next.js apps, including reveal, hover and tap micro-interactions, whileInView, stagger, AnimatePresence, layout and layoutId transitions, reorder, scroll-linked UI, and lightweight route-content transitions. Use when the user asks to add, refactor, or debug Motion or Framer Motion in App Router or Pages Router codebases, especially around server/client boundaries, reduced motion, LazyMotion, bundle size, hydration, or route transitions. Avoid for GSAP-style timelines, WebGL or 3D scenes, heavy scroll storytelling, or CSS-only effects unless Motion is explicitly requested.