---
name: Worldbuilding
slug: worldbuilding
category: Writing
description: Worldbuilding helps manage a fiction encyclopedia of characters, settings, themes, factions, and lore. Use it to auto-stub new entities, link related entries, and flag internal inconsistencies in the world.
github: "https://github.com/inkeep/open-knowledge/tree/main/packages/server/assets/skills/packs/worldbuilding"
language: TypeScript
stars: 3468
forks: 219
install: "npx degit https://github.com/inkeep/open-knowledge/tree/main/packages/server/assets/skills/packs/worldbuilding ~/.claude/skills/worldbuilding"
installs_to: ~/.claude/skills/worldbuilding
source_path: packages/server/assets/skills/packs/worldbuilding/SKILL.md
collection_size: 18
category_size: 1012
collection_url: "https://dirskills.com/collections/inkeep/open-knowledge"
added: 2026-08-16T07:02:42.231Z
last_synced: 2026-08-16T07:02:42.231Z
canonical_url: "https://dirskills.com/skills/worldbuilding"
---

# Worldbuilding

Worldbuilding helps manage a fiction encyclopedia of characters, settings, themes, factions, and lore. Use it to auto-stub new entities, link related entries, and flag internal inconsistencies in the world.

**Install:**

```bash
npx degit https://github.com/inkeep/open-knowledge/tree/main/packages/server/assets/skills/packs/worldbuilding ~/.claude/skills/worldbuilding
```

## README

# Worldbuilding pack — how to work here

This project is a fiction encyclopedia. The graph is the product: characters, settings, themes, factions, and lore that link to each other. The agent's main jobs are auto-stubbing new entities as they're mentioned and flagging contradictions. This skill holds those behaviors so templates and folder descriptions stay clean.

> This skill is pack guidance. The platform `/open-knowledge` skill (read/write/preview/linking/grounding rules) still governs every markdown operation — this layers the worldbuilding conventions on top.

## Folders

- **`characters/`** — one file per character (PC + NPC); frontmatter carries type, status, faction, first appearance.
- **`settings/`** — locations, regions, world-rules; frontmatter carries region, controlling faction, danger level. The "where" of the story.
- **`themes/`** — recurring narrative concerns (love, betrayal, identity). The "why." Themes work via opposition; each entry captures the theme and its tension.
- **`factions/`** — political, social, criminal, magical, religious groups. Ships `faction`, `political-faction`, and `religion` templates.
- **`lore/`** — history, mythology, cosmology, magic systems. Ships `lore`, `magic-system`, and `historical-event` templates.

## Agent behaviors (the core value)

- **Auto-stub on mention.** When a chapter, session log, or existing entry references a name not yet captured, stub a file in the right folder with backlinks to where it was mentioned.
- **Flag contradictions.** When a character's `faction` (or any field) contradicts their actions in narrative, or a setting is described two ways, surface the conflict — in fiction a contradiction is itself a story-shaping detail worth noting, not silently "fixing."
- **Thread the graph.** Link characters ↔ factions ↔ settings ↔ lore so each entry becomes a hub for everywhere it appears.
- Do NOT add TTRPG stat-block fields (`xp_awarded`, etc.) — those belong in a future TTRPG variant.

## Templates

Create with `write({ document: { path, template: "<name>" } })`. Templates carry only structure; section meaning is described here, not inside the document body.