narrative-quest-narrative-coherence

Use when creating any quest, mission, or story content — enforces the 5-step narrative coherence check: lore validation, conflict detection, quest registry, and contradiction prevention. Triggers: coherence check, lore validation, quest registry, narrative consistency.

6 stars

Best use case

narrative-quest-narrative-coherence is best used when you need a repeatable AI agent workflow instead of a one-off prompt.

Use when creating any quest, mission, or story content — enforces the 5-step narrative coherence check: lore validation, conflict detection, quest registry, and contradiction prevention. Triggers: coherence check, lore validation, quest registry, narrative consistency.

Teams using narrative-quest-narrative-coherence should expect a more consistent output, faster repeated execution, less prompt rewriting.

When to use this skill

  • You want a reusable workflow that can be run more than once with consistent structure.

When not to use this skill

  • You only need a quick one-off answer and do not need a reusable workflow.
  • You cannot install or maintain the underlying files, dependencies, or repository context.

Installation

Claude Code / Cursor / Codex

$curl -o ~/.claude/skills/quest-narrative-coherence/SKILL.md --create-dirs "https://raw.githubusercontent.com/fcsouza/agent-skills/main/plugins/game-dev/narrative/quest-narrative-coherence/SKILL.md"

Manual Installation

  1. Download SKILL.md from GitHub
  2. Place it in .claude/skills/quest-narrative-coherence/SKILL.md inside your project
  3. Restart your AI agent — it will auto-discover the skill

How narrative-quest-narrative-coherence Compares

Feature / Agentnarrative-quest-narrative-coherenceStandard Approach
Platform SupportNot specifiedLimited / Varies
Context Awareness High Baseline
Installation ComplexityUnknownN/A

Frequently Asked Questions

What does this skill do?

Use when creating any quest, mission, or story content — enforces the 5-step narrative coherence check: lore validation, conflict detection, quest registry, and contradiction prevention. Triggers: coherence check, lore validation, quest registry, narrative consistency.

Where can I find the source code?

You can find the source code on GitHub using the link provided at the top of the page.

SKILL.md Source

# Quest Narrative Coherence

## Purpose

Standalone enforcement skill: ensures every quest, mission, or story beat is consistent with existing world lore, prior quests, and active story arcs. No orphan quests. Ever.

## When to Use

Trigger: quest creation, mission design, story beat, narrative content, new quest, quest writing, lore check, narrative consistency, story coherence

MANDATORY: This skill must be read BEFORE `quest-mission-design`, `worldbuilding`, `story-structure-game`, or `character-design-narrative` when creating any narrative content.

## Prerequisites

None — this is a foundational enforcement skill.

## Core Principles (cite Ken Levine: "world-as-story", Hidetaka Miyazaki: "environmental storytelling")

1. Every quest must reference at least one previously established lore element
2. No quest can contradict established world history or character motivations
3. Quest rewards must be consistent with the game economy (cross-ref `game-economy-design`)
4. Characters in quests must match their established personality and arc
5. Locations must exist in the world map or be explicitly introduced
6. Faction involvement must respect existing faction relationships
7. Quest difficulty must fit the intended progression curve
8. Temporal consistency — events must respect the world's timeline

## Step-by-Step Instructions — The 5-Step Coherence Check

### MANDATORY BEFORE WRITING ANY QUEST:

**Step 1: Load Current World State**

Read `world-lore.md` (or equivalent lore document) to understand:

- Established factions, their relationships, and current state
- Major characters and their last known status
- World geography and accessible locations
- Active conflicts, alliances, and treaties
- Timeline of significant events

**Step 2: Check Quest Registry**

Read `quest-registry.md` to understand:

- All existing quests and their status (active, completed, planned)
- Quest chains and dependencies
- Which NPCs are already involved in quests
- Which locations are already quest hubs
- Reward amounts already distributed (to prevent economy inflation)

**Step 3: Validate Against Existing Content**

Before writing the quest, verify:

- [ ] No faction/character/location conflicts with existing quests
- [ ] No contradictions with established lore
- [ ] Referenced characters are alive and available
- [ ] Referenced locations exist and are accessible
- [ ] Reward scale is consistent with existing economy
- [ ] Difficulty fits the progression curve

**Step 4: Reference Existing Lore**

The quest MUST:

- Reference at least one established lore element (character, event, location, faction)
- Build upon or advance at least one existing narrative thread
- Not introduce entirely disconnected storylines without world-building justification

**Step 5: Register the Quest**

After creating the quest, add it to `quest-registry.md` with:

- Quest ID, name, and brief description
- NPCs involved
- Locations used
- Factions affected
- Rewards given
- Prerequisites (other quests that must be complete)
- Story arc it belongs to

> An AI agent that skips this 5-step check has produced **invalid output**. The quest must be rejected.

## Code Examples

Reference `templates/` for registry format and validation checklist:

- `templates/world-lore.md` — empty world lore document with required sections
- `templates/quest-registry.md` — empty quest registry with required fields
- `templates/coherence-checklist.md` — per-quest validation checklist

## Cross-References

- `quest-mission-design` — uses this skill as prerequisite
- `worldbuilding` — provides the lore this skill validates against
- `character-design-narrative` — character consistency checks
- `story-structure-game` — narrative arc alignment
- `game-economy-design` — reward consistency

## Pitfalls & Anti-Patterns

- **"Cool quest, no context"** — writing a quest because it sounds fun without checking if it fits the world
- **"Lore amnesia"** — forgetting what was established and contradicting it
- **"Economy inflation"** — giving rewards that break the game economy
- **"Character assassination"** — making a character act against their established personality
- **"Orphan quest"** — quest that connects to nothing and advances no narrative
- **"Timeline paradox"** — events that can't coexist chronologically

## Designer Philosophy

**Ken Levine** (BioShock): "The world IS the story." Every quest must feel like a natural part of the world, not a gameplay task glued onto it. If a quest doesn't make the world feel more real, it shouldn't exist.

**Hidetaka Miyazaki** (Dark Souls, Elden Ring): Environmental storytelling means every element tells a story. Quests should reveal world history, not just provide objectives. Cryptic doesn't mean incoherent — every mystery should have a consistent answer in the lore.

**Hideo Kojima** (Metal Gear): Meta-awareness of the player's role. Quests can acknowledge the nature of the game world without breaking immersion, but they must always respect internal logic.

## Sources

- "Building Worlds" — GDC 2019 Ken Levine
- "Designing Dark Souls" — GDC 2012 Hidetaka Miyazaki
- "The Art of Game Design" — Jesse Schell, Chapter on World Building
- "Narrative Design for Indie Games" — GDC 2020

Related Skills

narrative-worldbuilding

6
from fcsouza/agent-skills

Use when creating game worlds, lore, factions, geography, timelines, or establishing world consistency rules. Genre-agnostic — works for fantasy, sci-fi, modern, or abstract settings. Triggers: lore, factions, geography, world bible, world creation.

narrative-story-structure-game

6
from fcsouza/agent-skills

Use when designing interactive narratives, branching storylines, player agency systems, non-linear story structures, or act frameworks for games. Triggers: branching narrative, player agency, story arc, interactive story, dialogue.

narrative-character-design-narrative

6
from fcsouza/agent-skills

Use when creating game characters, NPCs, character arcs, dialogue systems, archetypes, or character bibles. Triggers: character, NPC, dialogue, archetype, character bible, motivation arc.

design-quest-mission-design

6
from fcsouza/agent-skills

Use when designing quests, missions, objectives, quest trees, or reward structures. Requires quest-narrative-coherence check before any quest creation. Triggers: quest, mission, objectives, quest tree, rewards.

react-animations

6
from fcsouza/agent-skills

Use when implementing animations, transitions, or motion effects in React apps. Invoke this skill whenever someone asks about animation, transition, motion, framer motion, react spring, GSAP, entrance/exit effects, scroll animation, parallax, gesture, drag, card flip, screen shake, health bar, damage numbers, loading states, page transitions, hover effects, or any element that should move, fade, scale, or respond to interaction — even if they don't use the word "animation".

openclaw-genie

6
from fcsouza/agent-skills

Use when the user asks about OpenClaw — installation, configuration, agents, channels, memory, tools, hooks, skills, deployment, Docker, multi-agent, OAuth, gateway, CLI, browser, exec, PDF, voice, secrets, sandboxing, sessions, cron, webhooks, heartbeat, sub-agents, nodes, companion devices, canvas, camera, or messaging platform integration. Also invoke for questions about running OpenClaw agents: memory recall (memory_search), cron scheduling, multi-agent setup, or any openclaw.json behavior. OpenClaw has proprietary configuration syntax (SecretRef, dmPolicy, node.invoke, tool profiles) and CLI commands that require this skill to answer correctly.

game-lore

6
from fcsouza/agent-skills

Adds or updates a single world lore entry (faction, location, NPC, or event) — validates against existing lore for consistency, applies the right template, and updates docs/world-lore.md. Extract the entry type (faction/location/npc/event) and name from the user's message.

game-expand

6
from fcsouza/agent-skills

Adds a new feature to an existing MVP plan — scoped architect interview, scope validation against original plan, and integration into the build sequence. Extract the feature name or description from the user's message. Requires docs/mvp-first-draft.md — run game-architect first.

game-build

6
from fcsouza/agent-skills

Builds a game component from the MVP plan — production TypeScript + Vitest tests + mock dependencies + build registry tracking. Extract the component name from the user's message (or "status" to check progress). Requires docs/mvp-first-draft.md — run game-architect first.

game-balance

6
from fcsouza/agent-skills

Analyzes a game system against design principles — economy health metrics, difficulty curve, reward schedules, and progression cost curves. Flags imbalances with severity levels. Use after creating an MVP plan with game-architect. Extract the analysis scope (economy/difficulty/progression/rewards/all) from the user's message.

game-architect

6
from fcsouza/agent-skills

Comprehensive game MVP interviewer and planner. Interviews you in progressive groups, researches genre conventions and reference games, then produces an actionable MVP First Draft with starter project files. Use when starting a new game project from scratch.

foundry-vtt-system-dev

6
from fcsouza/agent-skills

Covers building, extending, and maintaining Foundry VTT game systems for v13+. This skill applies when scaffolding a new system, defining Actor/Item types with TypeDataModel, customizing dice mechanics, implementing combat & initiative, building character sheets, handling system data migration, or configuring template.json. Triggers on: "Foundry system", "FVTT system", "system.json", "template.json", "foundryvtt system", "Actor subclass", "Item subclass", "custom dice", "DiceTerm", "system development", "game system", "RPG system", "statusEffects", "hotbarDrop", "custom enricher", "JournalEntryPage", "TokenDocument", or any task involving Foundry VTT system development.