Open Knowledge Pack Worldbuilding
Othersopen-knowledge-pack-worldbuildingOpen Knowledge Pack Worldbuilding is an Agent Skill for general use published in the inkeep/open-knowledge repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.
How 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 template bodies or folder descriptions. Complements the platform `open-knowledge` skill; does not replace it.
How to use this skill
Bring this guide into your coding agent with a prompt tailored to the tool you use.
- Open your project in Codex.
- Copy and paste the prompt below.
- Review files and risks before approving any action.
Inspect the Agent Skill at https://github.com/inkeep/open-knowledge/blob/HEAD/packages/server/assets/skills/packs/worldbuilding/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/open-knowledge-pack-worldbuilding, but wait for my approval before writing files or running scripts.
Copying this prompt does not install or run the skill. Review third-party files before use.
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.
Pack guidance. The platform
open-knowledgeskill still governs every markdown operation.
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. Shipsfaction,political-faction, andreligiontemplates.lore/— history, mythology, cosmology, magic systems. Shipslore,magic-system, andhistorical-eventtemplates.
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.