narrative-worldbuilding

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.

6 stars

Best use case

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

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.

Teams using narrative-worldbuilding 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/worldbuilding/SKILL.md --create-dirs "https://raw.githubusercontent.com/fcsouza/agent-skills/main/plugins/game-dev/narrative/worldbuilding/SKILL.md"

Manual Installation

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

How narrative-worldbuilding Compares

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

Frequently Asked Questions

What does this skill do?

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.

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

# Worldbuilding

## Purpose

Lore creation, geography design, faction dynamics, tone consistency, and world bible maintenance for any game setting. Genre-agnostic — works for fantasy, sci-fi, modern, horror, abstract, or any other setting.

## When to Use

Trigger: worldbuilding, lore, factions, geography, world design, setting, game world, tone, world bible, lore bible, world history, faction design, region design, location design

## Prerequisites

- `quest-narrative-coherence` (must be read first — ensures all world content stays internally consistent)

## Core Principles

> Hidetaka Miyazaki: "I always try to think about what kind of story the world itself tells."
> Ken Levine: "The world IS the story. Every corner should whisper something to the player."
> Will Wright: "A great simulation world has rules players can intuit without reading a manual."

1. **Internal consistency above all** — every fact, rule, and relationship must hold true across the entire world; contradictions destroy believability
2. **Show, don't exposition** — embed lore in the environment, item descriptions, NPC dialogue, and architecture rather than text dumps
3. **Factions need wants, not just labels** — every group must have goals (public and hidden), resources, enemies, and a reason to exist beyond "they're the bad guys"
4. **Geography shapes culture** — climate, terrain, and resources determine how civilizations develop, trade, fight, and build
5. **Rules before exceptions** — establish what is possible and impossible in the world before introducing special cases; magic/tech systems need clear costs and limits
6. **History creates present tension** — past events (wars, disasters, discoveries) should directly cause current conflicts and alliances
7. **Tone is a contract with the player** — once established, the world's tone (dark, whimsical, gritty, absurd) must be maintained; tonal whiplash breaks immersion

## Step-by-Step Instructions

### 1. Define the World Foundation

Start with `templates/world-bible.md`. Fill in the world overview first: name, genre, tone, themes, and time period. This anchors every decision that follows.

### 2. Establish Core Rules

Define what is possible and impossible. Does magic exist? Technology? Both? What are the costs and limits? These rules constrain everything else and prevent power creep.

### 3. Build History Backward

Start from the present state of the world and work backward. What war caused this border? What disaster made this region uninhabitable? What discovery enabled this technology? History should explain the present, not exist for its own sake.

### 4. Design Geography

Map regions, climates, resources, and travel routes. Geography determines trade, conflict, and cultural development. Use `templates/location-template.md` for each significant location.

### 5. Create Factions

Use `templates/faction-bible.md` for each faction. Every faction needs goals, enemies, allies, territory, and a gameplay role. Aim for at least 3 factions with interlocking relationships (ally/enemy/neutral dynamics that create player choice).

### 6. Define Cultural Elements

Customs, religions, languages, art, and social norms for each major group. Culture should emerge naturally from geography, history, and faction goals.

### 7. Write the Tone Guide

Document what fits and what doesn't. List reference media. This prevents tonal drift as more content is added by different contributors.

### 8. Register with Quest Narrative Coherence

All established lore becomes the canonical reference for `quest-narrative-coherence` validation. New quests, characters, and locations must align with the world bible.

## Code Examples

Reference `templates/` for all document structures:

- `templates/world-bible.md` — comprehensive world bible with all required sections
- `templates/faction-bible.md` — per-faction deep dive template
- `templates/location-template.md` — per-location design template

## Cross-References

- `quest-narrative-coherence` — validates all narrative content against this world
- `story-structure-game` — narrative arc design within this world
- `character-design-narrative` — characters must fit the world's tone, factions, and history
- `quest-mission-design` — quests must use established locations, factions, and lore

## Pitfalls & Anti-Patterns

- **"Generic fantasy #4,827"** — elves, dwarves, and orcs with no twist, no unique culture, no reason to exist in this specific world
- **"Lore encyclopedia syndrome"** — pages of history the player never encounters; if it doesn't affect gameplay or environmental storytelling, cut it
- **"Inconsistent lore"** — NPC A says the war was 100 years ago, NPC B says 50; maintain a single timeline source of truth
- **"Info dump NPCs"** — characters who exist only to deliver paragraphs of exposition instead of living in the world naturally
- **"Aesthetic without substance"** — a faction that looks cool but has no goals, no internal politics, no reason for the player to care
- **"Flat geography"** — every region feels the same; terrain, climate, and resources should create distinct identities and gameplay differences
- **"Tone whiplash"** — mixing grim dark with slapstick comedy without intentional purpose; tonal shifts need to be deliberate and earned

## Designer Philosophy

**Hidetaka Miyazaki** (Dark Souls, Elden Ring): Environmental storytelling is world design. Every crumbling ruin, every item description, every enemy placement tells a story. The world should reward curiosity — players who look closely find layers of meaning. Cryptic doesn't mean random; every mystery has an answer buried somewhere in the world. The feeling of discovery IS the narrative.

**Ken Levine** (BioShock): The world is the story. Rapture and Columbia aren't backdrops — they ARE the narrative. Every poster, every audio log, every architectural choice communicates ideology, history, and decay. When the world tells the story, the player feels like an archaeologist uncovering truth rather than a passive audience receiving exposition.

**Will Wright** (SimCity, The Sims, Spore): Simulation worlds emerge from rules. Define the systems — resources, needs, relationships, constraints — and the world generates stories on its own. Players don't need to be told the world is alive if they can see cause and effect playing out. The best worlds are ones where players form their own theories about how things work.

## Sources

- "Building Worlds That Tell Stories" — GDC 2019 Ken Levine
- "Designing Dark Souls: The Interconnected World" — GDC 2012 Hidetaka Miyazaki
- "The Art of Game Design" — Jesse Schell, Chapters on World Building and Story
- "Creating Compelling Game Worlds" — GDC 2017
- "Environmental Storytelling: Techniques and Best Practices" — GDC 2020
- "Simulation and World Systems in Game Design" — Will Wright, various GDC talks

Related Skills

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-quest-narrative-coherence

6
from fcsouza/agent-skills

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.

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.

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.

foundry-vtt-module-dev

6
from fcsouza/agent-skills

Covers building, extending, debugging, and maintaining Foundry VTT modules for v13+. This skill applies when scaffolding a new module, writing custom Actor/Item types with TypeDataModel, building ApplicationV2 sheets or dialogs, registering hooks or settings, implementing socket communication, extending the canvas with PIXI.js, managing compendium packs, using ActiveEffects, setting up TypeScript with fvtt-types, configuring Vite/Rollup builds, localizing strings, or migrating modules between Foundry versions. Triggers on: "Foundry module", "FVTT", "FoundryVTT", "foundryvtt module", "ApplicationV2", "TypeDataModel", "actor sheet", "module.json", "fvtt-types", "libWrapper", "socketlib", or any task involving Foundry VTT module development.