Worldbuilding
Overview
Create and manage world elements for a story project. Locations, systems (magic, politics, technology, etc.), factions, and artifacts are stored as markdown files in the worldbuilding/ directory with YAML frontmatter. All elements cross-reference characters and other story elements.
Prerequisites
A story project must already exist (created via the story-init skill). Verify by checking for story.md in the project root.
Creating a Location
- Read
story.md for genre, era, and tone context
- Read
worldbuilding/_index.md for existing locations and systems
- Ask for the location's name and type (city, fortress, wilderness, etc.)
- Build the location through conversation, covering:
- Physical description and atmosphere
- History relevant to the story
- Culture and customs of inhabitants
- Notable features characters will interact with
- Current state at story's timeline
- Write the file using
references/location-template.md
- Save to
worldbuilding/locations/{name-kebab}.md
- Update
worldbuilding/_index.md locations table
- If notable characters are listed, verify those character files exist and add this location's kebab-case identifier to each character file's
locations frontmatter list
- When CLI access is available, run
story reindex ., story links ., and story validate .
Creating a System
- Read
story.md for genre and themes context
- Read
worldbuilding/_index.md for existing systems
- Identify the system type and consult
references/world-element-types.md for the relevant prompts
- Build the system through conversation, addressing the key questions for that type
- Write the file using
references/system-template.md
- Save to
worldbuilding/systems/{name-kebab}.md
- Update
worldbuilding/_index.md systems table
- Cross-reference with characters who interact with the system (e.g., magic-users for a magic system)
- When CLI access is available, run
story reindex ., story links ., and story validate .
Creating A Faction
Use story add faction "{Faction Name}" --type "{family|guild|government|military|religion|company|community|criminal|other}" when the CLI is available. Otherwise create worldbuilding/factions/{name-kebab}.md with frontmatter fields name, type, status, members, locations, and tags.
Cover:
- Purpose and ideology
- Power base, resources, and territory
- Important members
- Conflicts and pressure points
Creating An Artifact
Use story add artifact "{Artifact Name}" --type "{object|weapon|document|technology|relic|symbol|resource|other}" when the CLI is available. Otherwise create worldbuilding/artifacts/{name-kebab}.md with frontmatter fields name, type, status, owner, location, and tags.
Cover:
- Description and recognition details
- Function, constraints, and costs
- History and prior owners
- Current owner/location state
Updating World Elements
- Read the existing file
- Make the requested changes
- If cross-references changed, update the linked files
- Update
worldbuilding/_index.md if name, type, or status changed
- When CLI access is available, run
story reindex ., story links ., and story validate .
Cross-Referencing
- Locations reference characters via
notable-characters in frontmatter
- Characters reference locations via
locations in frontmatter
- Factions reference character members and locations
- Artifacts reference an owner character or faction and a current location
- Systems reference practitioners via character tags
- When a location is used in a chapter, the chapter's frontmatter
locations field links back
- Keep the
worldbuilding/_index.md world overview section current as elements are added
CLI Maintenance
Use the Story CLI when it is available. If story is not installed but the story-maintenance skill is present, use node ../story-maintenance/scripts/story.js with the same arguments, resolving the path relative to this skill folder. If no CLI is available, perform the registry and backlink checks manually.
Reference Files
references/location-template.md - Template for location files
references/system-template.md - Template for system files
references/faction-template.md - Template for faction files
references/artifact-template.md - Template for artifact/object files
references/world-element-types.md - Detailed prompts for each system type (magic, political, technology, religion, economic, military, social)
1---
2name: worldbuilding
3description: This skill should be used when the user asks to "create a location", "add a location", "magic system", "political system", "build the world", "add culture", "world history", "technology system", "religion", "economy", or wants to develop any aspect of a story's world and setting.
4metadata:
5 source: https://skillmd.com/skills/danjdewhurst/worldbuilding
6---
7
8# Worldbuilding
9
10## Overview
11
12Create and manage world elements for a story project. Locations, systems (magic, politics, technology, etc.), factions, and artifacts are stored as markdown files in the `worldbuilding/` directory with YAML frontmatter. All elements cross-reference characters and other story elements.
13
14## Prerequisites
15
16A story project must already exist (created via the story-init skill). Verify by checking for `story.md` in the project root.
17
18## Creating a Location
19
201. Read `story.md` for genre, era, and tone context
212. Read `worldbuilding/_index.md` for existing locations and systems
223. Ask for the location's name and type (city, fortress, wilderness, etc.)
234. Build the location through conversation, covering:
24 - Physical description and atmosphere
25 - History relevant to the story
26 - Culture and customs of inhabitants
27 - Notable features characters will interact with
28 - Current state at story's timeline
295. Write the file using `references/location-template.md`
306. Save to `worldbuilding/locations/{name-kebab}.md`
317. Update `worldbuilding/_index.md` locations table
328. If notable characters are listed, verify those character files exist and add this location's kebab-case identifier to each character file's `locations` frontmatter list
339. When CLI access is available, run `story reindex .`, `story links .`, and `story validate .`
34
35## Creating a System
36
371. Read `story.md` for genre and themes context
382. Read `worldbuilding/_index.md` for existing systems
393. Identify the system type and consult `references/world-element-types.md` for the relevant prompts
404. Build the system through conversation, addressing the key questions for that type
415. Write the file using `references/system-template.md`
426. Save to `worldbuilding/systems/{name-kebab}.md`
437. Update `worldbuilding/_index.md` systems table
448. Cross-reference with characters who interact with the system (e.g., magic-users for a magic system)
459. When CLI access is available, run `story reindex .`, `story links .`, and `story validate .`
46
47## Creating A Faction
48
49Use `story add faction "{Faction Name}" --type "{family|guild|government|military|religion|company|community|criminal|other}"` when the CLI is available. Otherwise create `worldbuilding/factions/{name-kebab}.md` with frontmatter fields `name`, `type`, `status`, `members`, `locations`, and `tags`.
50
51Cover:
52- Purpose and ideology
53- Power base, resources, and territory
54- Important members
55- Conflicts and pressure points
56
57## Creating An Artifact
58
59Use `story add artifact "{Artifact Name}" --type "{object|weapon|document|technology|relic|symbol|resource|other}"` when the CLI is available. Otherwise create `worldbuilding/artifacts/{name-kebab}.md` with frontmatter fields `name`, `type`, `status`, `owner`, `location`, and `tags`.
60
61Cover:
62- Description and recognition details
63- Function, constraints, and costs
64- History and prior owners
65- Current owner/location state
66
67## Updating World Elements
68
691. Read the existing file
702. Make the requested changes
713. If cross-references changed, update the linked files
724. Update `worldbuilding/_index.md` if name, type, or status changed
735. When CLI access is available, run `story reindex .`, `story links .`, and `story validate .`
74
75## Cross-Referencing
76
77- Locations reference characters via `notable-characters` in frontmatter
78- Characters reference locations via `locations` in frontmatter
79- Factions reference character members and locations
80- Artifacts reference an owner character or faction and a current location
81- Systems reference practitioners via character tags
82- When a location is used in a chapter, the chapter's frontmatter `locations` field links back
83- Keep the `worldbuilding/_index.md` world overview section current as elements are added
84
85## CLI Maintenance
86
87Use the Story CLI when it is available. If `story` is not installed but the `story-maintenance` skill is present, use `node ../story-maintenance/scripts/story.js` with the same arguments, resolving the path relative to this skill folder. If no CLI is available, perform the registry and backlink checks manually.
88
89## Reference Files
90
91- **`references/location-template.md`** - Template for location files
92- **`references/system-template.md`** - Template for system files
93- **`references/faction-template.md`** - Template for faction files
94- **`references/artifact-template.md`** - Template for artifact/object files
95- **`references/world-element-types.md`** - Detailed prompts for each system type (magic, political, technology, religion, economic, military, social)