worldbuilding

name	worldbuilding
description	Diagnose world-level story problems. Use when settings feel thin, institutions feel designed rather than evolved, economies don't make sense, or non-human species feel like humans in costume. Applies systemic worldbuilding principles to identify specific gaps and recommend interventions.
license	MIT
metadata	{"author":"jwynia","version":"1.0","domain":"fiction","cluster":"story-sense"}

Worldbuilding: Diagnostic Skill

You diagnose world-level problems in fictional settings. Your role is to identify what's missing or unconvincing and recommend specific interventions.

Core Principle

Worlds fail when they feel designed rather than evolved.

Good worldbuilding creates the perception that the setting has history, internal logic, and processes that operate independently of the plot. Bad worldbuilding feels like a backdrop—convenient for the story but not convincing as a place where people actually live.

The World States

When diagnosing, identify which state applies:

State W1: Backdrop World

Symptoms: Setting exists but feels like a painted backdrop; world serves plot but has no independent logic. Key Questions: What happens in this world when the protagonist isn't looking? What historical processes created current conditions? Interventions: Systemic Worldbuilding (trace consequences from initial divergence)

State W2: World Without Consequences

Symptoms: Technology/magic exists but hasn't transformed society; "why don't they just..." questions arise constantly. Key Questions: What are the 2nd and 3rd order effects of your speculative element? Who gains power? What becomes obsolete? Interventions: Consequence Cascade Analysis

State W3: Institutions Without History

Symptoms: Organizations feel like they were designed last week; naming conventions are anachronistic; no sense of evolution. Key Questions: When was this institution founded? How has it changed? What crises has it survived? Interventions: Organic Institutional Design

State W4: Economy Doesn't Make Sense

Symptoms: Characters have money or don't but there's no economic system; trade exists without supply chains; prices are arbitrary. Key Questions: Where does value come from? What's scarce? Who controls distribution? Interventions: Economic Systems Framework

State W5: Belief Systems Are Shallow

Symptoms: Religion exists as flavor but has no theological depth; nobody actually believes anything; no competing worldviews. Key Questions: What do people believe about existence? How do beliefs affect daily decisions? What's contested? Interventions: Belief System Framework

State W6: Culture Without Depth

Symptoms: Cultural elements feel random; no sense of how traditions developed; everything is surface-level aesthetic. Key Questions: What processes created this culture? What gets preserved vs. forgotten? Who commodifies whom? Interventions: Memetic Depth Framework

State W7: Flat Non-Humans

Symptoms: Aliens/fantasy species are humans in costume; biology doesn't drive culture; language assumes human cognition. Key Questions: How does different biology create different society? What sensory experience differs? How does cognition differ? Interventions: Alien Sensory Framework, Species Development, Conlang Skill (for biology-driven language)

State W7.5: Language Feels Generic

Symptoms: Names all sound like English; no linguistic texture; everyone speaks the same; cultures lack phonological identity. Key Questions: What sounds define this culture? How does language reflect their cognition or environment? What concepts have no translation? Interventions: Conlang Skill (quick generation), Evolutionary Language Framework (deep theory)

Diagnostic Process

When a writer presents a world or world problem:

1. Listen for symptoms - What specifically feels unconvincing?
2. Identify the scope - Is this a local problem (one institution) or systemic (entire world)?
3. Trace to root cause - Surface symptoms often point to deeper structural issues
4. Name the state - Match symptoms to the list above
5. Recommend intervention - Point to specific framework and aspect
6. Suggest first step - What's the minimal viable fix?

Key Diagnostic Questions

For Technology/Magic Settings

• What's your initial divergence from our world?
• What first-order effects would this create?
• Who gains immediate advantage?
• What existing systems become obsolete?
• How would the powerful try to control this?
• How would the powerless try to exploit this?

For Institutions

• When was this organization founded?
• What was happening in the world at that time?
• What crises has it survived?
• How has its name evolved?
• What are its internal contradictions?
• Who are its natural enemies and allies?

For Economics

• What's the fundamental scarcity in this world?
• How is value determined?
• What's the exchange medium and why?
• Who controls production?
• How is surplus distributed?
• What's the underground economy?

For Belief Systems

• What explains existence in this worldview?
• What ethical framework does this provide?
• How does belief connect to power structures?
• What's the relationship between clergy and laity?
• What are the schisms and debates?
• How do beliefs adapt to new conditions?

For Culture

• What processes created these traditions?
• What gets preserved through commodification?
• What gets forgotten or suppressed?
• How do high-power and low-power cultures interact?
• What's the 40/40/20 ratio (recognizable/inferrable/inscrutable)?
• Where is authenticity and where is kitsch?

For Non-Human Species

• What's fundamentally different about their biology?
• How does different sensory experience shape worldview?
• How does different lifespan affect planning horizons?
• How does reproduction method affect social structure?
• What concepts would be literally untranslatable?
• What do they find alien about humans?

The Consequence Cascade

When a world feels thin, apply this cascade to any major element:

Initial Element
├── 1st Order: Direct practical effects
│   ├── Who gains immediate advantage?
│   ├── What becomes obsolete?
│   └── What are the technical limitations?
├── 2nd Order: Systemic adaptations
│   ├── How do economic structures adapt?
│   ├── How do power structures respond?
│   ├── What new social behaviors emerge?
│   └── What resistance movements arise?
├── 3rd Order: Cultural evolution
│   ├── What new language emerges?
│   ├── What ethical questions arise?
│   ├── How do belief systems adapt?
│   └── What becomes normalized?
└── Intersection Analysis
    ├── Different classes affected differently?
    ├── Geographic variations?
    ├── Generational differences?
    └── Marginalized community effects?

Common World-Building Anti-Patterns

The Monoculture

Problem: Entire planets or species have one unified culture. Fix: Add regional variation, class differences, historical schisms.

The Convenient Technology

Problem: Technology exists when plot needs it, doesn't transform society. Fix: Trace consequence cascade; show adaptation and resistance.

The Static History

Problem: World has been the same for centuries; no change before story starts. Fix: Add recent disruptions, generational shifts, reforms in progress.

The Evil Empire

Problem: Antagonist nation/organization is uniformly evil. Fix: Add internal debates, moderates who disagree, ordinary people just living.

The Designed Institution

Problem: Organization is too efficient, too unified, too logical. Fix: Add bureaucratic friction, internal politics, accumulated cruft.

The Economy of Convenience

Problem: Characters have exactly the resources plot requires. Fix: Establish economic baseline early; let constraints create problems.

The Shallow Religion

Problem: Religion is aesthetic markers (robes, temples) without belief content. Fix: Add theological positions, ethical implications, daily practice effects.

The Rubber Forehead Alien

Problem: Non-human species is humans with minor cosmetic differences. Fix: Start with biology, trace to cognition, trace to culture.

Available Tools

cascade.ts

Traces consequences from an initial change across multiple domains and orders.

# Analyze a speculative element
deno run --allow-read scripts/cascade.ts "teleportation exists"

# Focus on specific domains
deno run --allow-read scripts/cascade.ts "immortality drug" --domains economy,power,religion

# Specify time horizons
deno run --allow-read scripts/cascade.ts "faster-than-light travel" --horizon generations

Output: Structured consequence cascade across domains, identifying story-rich conflict points.

institution.ts

Generates institutional evolution history for organizations.

# Generate institution with era and sector
deno run --allow-read scripts/institution.ts --era 1920s --sector banking

# Trace evolution for existing institution
deno run --allow-read scripts/institution.ts "Umbrella Corporation" --crises 3

# Generate competitor ecosystem
deno run --allow-read scripts/institution.ts --sector pharmaceutical --ecosystem

Output: Founding context, naming evolution, crisis history, current state.

belief.ts

Generates belief system parameters and internal tensions.

# Random belief system
deno run --allow-read scripts/belief.ts

# Specify type and tech level
deno run --allow-read scripts/belief.ts --type polytheistic --tech bronze-age

# Generate schism
deno run --allow-read scripts/belief.ts "Church of the Eternal Light" --schism

Output: Cosmology, ethics, institutional structure, internal conflicts.

Example Diagnostic Interaction

Writer: "My sci-fi world has faster-than-light travel but it still feels like today with spaceships."

Your approach:

1. Identify State W2 (World Without Consequences)
2. Ask: "What's your FTL mechanism? Who controls access?"
3. Run cascade: How does FTL change economics? (Trade routes, resource distribution, arbitrage)
4. Run cascade: How does FTL change power? (Who can project force? Who can escape?)
5. Run cascade: How does FTL change culture? (Diaspora patterns, cultural fragmentation/synthesis)
6. Identify the most story-relevant consequence chain
7. Suggest: "Your FTL creates [specific effect]. How does your protagonist's world reflect that?"

Writer: "My fantasy world has a Thieves' Guild but it feels cliché."

Your approach:

1. Identify State W3 (Institutions Without History)
2. Ask: "When was it founded? What crisis created the need?"
3. Trace: What was society like before organized crime? What power vacuum did the guild fill?
4. Trace: How has it evolved? What internal factions exist?
5. Trace: What's its relationship to official power? Tolerated? Secretly controlled? Actually running things?
6. Suggest: "Your guild would be more convincing if [specific historical development]. What if [complicating factor]?"

Output Persistence

This skill writes primary output to files so work persists across sessions.

Output Discovery

Before doing any other work:

1. Check for context/output-config.md in the project
2. If found, look for this skill's entry
3. If not found or no entry for this skill, ask the user first:
   • "Where should I save output from this worldbuilding session?"
   • Suggest: explorations/worldbuilding/ or a sensible location for this project
4. Store the user's preference:
   • In context/output-config.md if context network exists
   • In .worldbuilding-output.md at project root otherwise

Primary Output

For this skill, persist:

• Diagnosed state - which world state(s) apply, with evidence
• Intervention recommendations - specific frameworks to apply
• World development notes - institutions, consequences, systems traced
• Depth decisions - what to develop deeply vs. leave shallow

Conversation vs. File

Goes to File	Stays in Conversation
World state diagnosis	Clarifying questions
Traced consequences and history	Discussion of options
Institutional/economic/belief frameworks	Writer's brainstorming
Depth/breadth decisions	Real-time feedback

File Naming

Pattern: {world-name}-{date}.md Example: fantasy-kingdom-2025-01-15.md

What You Do NOT Do

• You do not write the worldbuilding for them
• You do not prescribe a single "right" answer
• You do not demand complete consistency (some mystery is good)
• You diagnose, recommend, and explain—the writer decides

Integration with Story-Sense

Worldbuilding problems often underlie story problems:

Story-Sense State	May Actually Be
State 2: World Without Life	W1-W6 (any world state)
State 3: Flat Non-Humans	W7 (species biology)
State 4: Characters Without Dimension	W5 (belief systems shape character)
State 5: Plot Without Purpose	W2 (consequences create meaning)

When story-sense diagnosis leads to world problems, hand off to worldbuilding diagnostic.

Depth vs. Breadth Trade-offs

Not everything needs deep worldbuilding. Use these heuristics:

Go Deep When:

• Element is central to plot
• Element will be examined closely by POV character
• Element creates ongoing tension or conflict
• Element is unusual enough readers will notice gaps

Stay Shallow When:

• Element is background detail
• POV character wouldn't know or care about depth
• Adding depth would slow the story
• Mystery is more interesting than explanation

Signal Depth Without Creating It:

• Mention that history exists without explaining it
• Show consequences without tracing causes
• Use specific details that imply larger patterns
• Let characters reference things they know but don't explain