Worldbuilding & Lore Delivery
How to author a deep, internally consistent world and deliver it through space and objects instead of exposition — and how to do that under procedural / AI generation without the world contradicting itself or collapsing into generic fantasy. The spine: build the whole iceberg as frozen, typed, queryable canon, then generate only the leaves that read from it.
When to use this
- Authoring the world bible (cosmology, timeline, factions, geography, economy, magic laws)
- Deciding how lore reaches the player (item text, environment, aftermath vs. cutscene/dialogue)
- Defining the world's identity/register so generation doesn't drift toward Tolkien defaults
- Designing mythology and "deep history" that the player can actually feel
- Making each mechanic carry the theme (ludonarrative harmony) and answer a lore question
- Diagnosing info-dumps, "wiki voice", generic-fantasy regression, or unbounded ambiguity
Scope
This skill owns the world bible and lore delivery. Adjacent concerns live in siblings:
- The space lore is delivered through →
open-world-design
- How to generate content + the sameness problem →
procedural-generation, procgen-review
- Keeping generated lore text coherent in voice →
ai-authored-content-coherence
- Quests that carry lore →
narrative-and-quest-design
- Visual register / readability of the alien look →
art-direction-and-readability
- Mechanics whose lore you're justifying (loot, economy, death) →
rpg-systems, permadeath-and-lethality
- "Interesting decisions" / ludonarrative theory →
game-design-fundamentals, systemic-emergent-design
How the pieces fit
GUIDE.md — the why: five sub-domains (iceberg, environmental/item delivery, alien-but-coherent identity, deep history, ludonarrative harmony), each with exemplars, citations, a "test for" criterion, a named failure mode, and the procedural/AI-authoring implication.
CHECKLIST.md — the what to do: Do/Don't + Test-for, grouped by sub-domain.
Source & epistemic status. Distilled from a deep-research synthesis (Hemingway's iceberg; Jenkins's four modes; Sanderson's & Jemisin's craft laws; Hocking's ludonarrative dissonance; FromSoftware/Morrowind/Elden Ring/RDR2 exemplars). The literary craft sources (1932–2018) predate LLM authors and assume a human who holds the iceberg in mind — so the AI-authoring mitigations (frozen typed canon, generate-leaves-not-roots, validators-before-generators) are engineering hypotheses to test, not received best practice. Source caveats are carried inline in GUIDE.md §6.
The one idea to anchor on
Omission is only safe over a backbone that exists. Hemingway: a writer who omits things he knows makes the reader feel them; one who omits what he doesn't know "only makes hollow places." For an LLM that fails by exactly that route, the fix is to make the submerged 90% an explicit, typed, frozen canon graph — then generate surface artifacts that only read from it. Never invent a backbone fact at the moment you write an item description.
Start with GUIDE.md, then apply CHECKLIST.md.
1---2name: worldbuilding-and-lore3description: Use when building a world bible and deciding how lore reaches the player — the iceberg principle (author the whole world, surface ~10%), environmental & item-description storytelling, an "alien but coherent" identity that survives procedural generation, deep history as faction-proxy pantheons, and ludonarrative harmony (mechanics that are the story). Also use to diagnose lore that info-dumps, feels generic-fantasy, or has gaps that read as contradictions rather than mystery. Triggers on "worldbuilding", "world bible", "lore", "iceberg", "environmental storytelling", "item descriptions", "show don't tell", "alien but coherent", "ludonarrative", "lore dump", "deep history", "mythology".4---56# Worldbuilding & Lore Delivery78How to author a deep, internally consistent world and deliver it through space and objects instead of exposition — and how to do that under procedural / AI generation without the world contradicting itself or collapsing into generic fantasy. The spine: **build the whole iceberg as frozen, typed, queryable canon, then generate only the leaves that read from it.**910## When to use this1112- Authoring the world bible (cosmology, timeline, factions, geography, economy, magic laws)13- Deciding *how* lore reaches the player (item text, environment, aftermath vs. cutscene/dialogue)14- Defining the world's identity/register so generation doesn't drift toward Tolkien defaults15- Designing mythology and "deep history" that the player can actually feel16- Making each mechanic carry the theme (ludonarrative harmony) and answer a lore question17- Diagnosing info-dumps, "wiki voice", generic-fantasy regression, or unbounded ambiguity1819## Scope2021This skill owns **the world bible and lore *delivery*.** Adjacent concerns live in siblings:22- The *space* lore is delivered through → `open-world-design`23- *How* to generate content + the sameness problem → `procedural-generation`, `procgen-review`24- Keeping generated lore text coherent in voice → `ai-authored-content-coherence`25- Quests that carry lore → `narrative-and-quest-design`26- Visual register / readability of the alien look → `art-direction-and-readability`27- Mechanics whose lore you're justifying (loot, economy, death) → `rpg-systems`, `permadeath-and-lethality`28- "Interesting decisions" / ludonarrative theory → `game-design-fundamentals`, `systemic-emergent-design`2930## How the pieces fit3132- **`GUIDE.md`** — the *why*: five sub-domains (iceberg, environmental/item delivery, alien-but-coherent identity, deep history, ludonarrative harmony), each with exemplars, citations, a "test for" criterion, a named failure mode, and the procedural/AI-authoring implication.33- **`CHECKLIST.md`** — the *what to do*: Do/Don't + Test-for, grouped by sub-domain.3435**Source & epistemic status.** Distilled from a deep-research synthesis (Hemingway's iceberg; Jenkins's four modes; Sanderson's & Jemisin's craft laws; Hocking's ludonarrative dissonance; FromSoftware/Morrowind/Elden Ring/RDR2 exemplars). The literary craft sources (1932–2018) predate LLM authors and assume a human who *holds* the iceberg in mind — so the **AI-authoring mitigations (frozen typed canon, generate-leaves-not-roots, validators-before-generators) are engineering hypotheses to test, not received best practice.** Source caveats are carried inline in `GUIDE.md §6`.3637## The one idea to anchor on3839> **Omission is only safe over a backbone that exists.** Hemingway: a writer who omits things he *knows* makes the reader feel them; one who omits what he *doesn't* know "only makes hollow places." For an LLM that fails by exactly that route, the fix is to make the submerged 90% an explicit, typed, frozen canon graph — then generate surface artifacts that only *read from* it. Never invent a backbone fact at the moment you write an item description.4041Start with `GUIDE.md`, then apply `CHECKLIST.md`.