worldbuilding
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.
By danjdewhurst · 591 installs
npx skills add danjdewhurst/story-skills --skill worldbuilding
Source repository · Upstream listing
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
1. Read story.md for genre, era, and tone context
2. Read worldbuilding/ index.md for existing locations and systems
3. Ask for the location's name and type (city, fortress, wilderness, etc.)
4. 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
5. Write the file using references/location template.md
6. Save to worldbuilding/locations/{name kebab}.md
7. Update worldbuilding/ index.md locations table
8. 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
9. When CLI access is available, run story reindex . , story links . , and story validate .
Creating a System
1. Read story.md for genre and themes context
2. Read worldbuilding/ index.md for existing systems
3. Identify the system type and consult references/world element types.md for the relevant prompts
4. Build the system through conversation, addressing the key questions for that type
5. Write the file using references/system template.md
6. Save to worldbuilding/systems/{name kebab}.md
7. Update worldbuilding/ index.md systems table
8. Cross reference with characters who interact with the system (e.g., magic users for a magic system)
9. 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
1. Read the existing file
2. Make the requested changes
3. If cross references changed, update the linked files
4. Update worldbuilding/ index.md if name, type, or status changed
5. 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)