$npx -y skills add inkeep/open-knowledge --skill worldbuildingHow to work in a Worldbuilding project (the worldbuilding starter pack): a fiction encyclopedia of characters, settings, themes, factions, and lore. Read when the project has these folders. Carries the auto-stub and consistency behaviors so that guidance does not live inside te
| 1 | # Worldbuilding pack — how to work here |
| 2 | |
| 3 | 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. |
| 4 | |
| 5 | > Pack guidance. The platform `open-knowledge` skill still governs every markdown operation. |
| 6 | |
| 7 | ## Folders |
| 8 | |
| 9 | - **`characters/`** — one file per character (PC + NPC); frontmatter carries type, status, faction, first appearance. |
| 10 | - **`settings/`** — locations, regions, world-rules; frontmatter carries region, controlling faction, danger level. The "where" of the story. |
| 11 | - **`themes/`** — recurring narrative concerns (love, betrayal, identity). The "why." Themes work via opposition; each entry captures the theme and its tension. |
| 12 | - **`factions/`** — political, social, criminal, magical, religious groups. Ships `faction`, `political-faction`, and `religion` templates. |
| 13 | - **`lore/`** — history, mythology, cosmology, magic systems. Ships `lore`, `magic-system`, and `historical-event` templates. |
| 14 | |
| 15 | ## Agent behaviors (the core value) |
| 16 | |
| 17 | - **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. |
| 18 | - **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." |
| 19 | - **Thread the graph.** Link characters ↔ factions ↔ settings ↔ lore so each entry becomes a hub for everywhere it appears. |
| 20 | - Do NOT add TTRPG stat-block fields (`xp_awarded`, etc.) — those belong in a future TTRPG variant. |
| 21 | |
| 22 | ## Templates |
| 23 | |
| 24 | Create with `write({ document: { path, template: "<name>" } })`. Templates carry only structure; section meaning is described here, not inside the document body. |