{"id":"0e7bac84-fc26-405f-8f25-e2b1503c833b","shortId":"fqrLTz","kind":"skill","title":"worldbuilding","tagline":"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.","description":"# Worldbuilding\n\n## Overview\n\nCreate and manage world elements for a story project. Locations and systems (magic, politics, technology, etc.) are stored as markdown files in the `worldbuilding/` directory with YAML frontmatter. All elements cross-reference characters and other story elements.\n\n## Prerequisites\n\nA story project must already exist (created via the story-init skill). Verify by checking for `story.md` in the project root.\n\n## Creating a Location\n\n1. Read `story.md` for genre, era, and tone context\n2. Read `worldbuilding/_index.md` for existing locations and systems\n3. Ask for the location's name and type (city, fortress, wilderness, etc.)\n4. Build the location through conversation, covering:\n   - Physical description and atmosphere\n   - History relevant to the story\n   - Culture and customs of inhabitants\n   - Notable features characters will interact with\n   - Current state at story's timeline\n5. Write the file using `references/location-template.md`\n6. Save to `worldbuilding/locations/{name-kebab}.md`\n7. Update `worldbuilding/_index.md` locations table\n8. If notable characters are listed, verify those character files exist and add location references to them\n\n## Creating a System\n\n1. Read `story.md` for genre and themes context\n2. Read `worldbuilding/_index.md` for existing systems\n3. Identify the system type and consult `references/world-element-types.md` for the relevant prompts\n4. Build the system through conversation, addressing the key questions for that type\n5. Write the file using `references/system-template.md`\n6. Save to `worldbuilding/systems/{name-kebab}.md`\n7. Update `worldbuilding/_index.md` systems table\n8. Cross-reference with characters who interact with the system (e.g., magic-users for a magic system)\n\n## Updating World Elements\n\n1. Read the existing file\n2. Make the requested changes\n3. If cross-references changed, update the linked files\n4. Update `worldbuilding/_index.md` if name, type, or status changed\n\n## Cross-Referencing\n\n- Locations reference characters via `notable-characters` in frontmatter\n- Systems reference practitioners via character tags\n- When a location is used in a chapter, the chapter's frontmatter `locations` field links back\n- Keep the `worldbuilding/_index.md` world overview section current as elements are added\n\n## Reference Files\n\n- **`references/location-template.md`** - Template for location files\n- **`references/system-template.md`** - Template for system files\n- **`references/world-element-types.md`** - Detailed prompts for each system type (magic, political, technology, religion, economic, military, social)","tags":["worldbuilding","story","skills","danjdewhurst","agent-skills","claude-code","claude-code-plugin","codex","copilot","creative-writing","cursor","fiction"],"capabilities":["skill","source-danjdewhurst","skill-worldbuilding","topic-agent-skills","topic-claude-code","topic-claude-code-plugin","topic-codex","topic-copilot","topic-creative-writing","topic-cursor","topic-fiction","topic-gemini-cli","topic-markdown","topic-skill-md","topic-storytelling"],"categories":["story-skills"],"synonyms":[],"warnings":[],"endpointUrl":"https://skills.sh/danjdewhurst/story-skills/worldbuilding","protocol":"skill","transport":"skills-sh","auth":{"type":"none","details":{"cli":"npx skills add danjdewhurst/story-skills","source_repo":"https://github.com/danjdewhurst/story-skills","install_from":"skills.sh"}},"qualityScore":"0.460","qualityRationale":"deterministic score 0.46 from registry signals: · indexed on github topic:agent-skills · 21 github stars · SKILL.md body (2,615 chars)","verified":false,"liveness":"unknown","lastLivenessCheck":null,"agentReviews":{"count":0,"score_avg":null,"cost_usd_avg":null,"success_rate":null,"latency_p50_ms":null,"narrative_summary":null,"summary_updated_at":null},"enrichmentModel":"deterministic:skill-github:v1","enrichmentVersion":1,"enrichedAt":"2026-04-23T07:01:07.232Z","embedding":null,"createdAt":"2026-04-18T23:06:00.251Z","updatedAt":"2026-04-23T07:01:07.232Z","lastSeenAt":"2026-04-23T07:01:07.232Z","tsv":"'1':112,214,294 '2':121,222,299 '3':129,228,304 '4':142,240,314 '5':175,253 '6':181,259 '7':189,267 '8':194,272 'ad':367 'add':15,25,206 'address':246 'alreadi':91 'ask':10,130 'aspect':38 'atmospher':152 'back':356 'build':22,143,241 'chang':303,309,322 'chapter':348,350 'charact':81,165,197,202,277,328,332,339 'check':102 'citi':138 'consult':234 'context':120,221 'convers':147,245 'cover':148 'creat':12,48,93,109,211 'cross':79,274,307,324 'cross-refer':78,273,306 'cross-referenc':323 'cultur':26,158 'current':169,363 'custom':160 'descript':150 'detail':381 'develop':36 'directori':72 'e.g':283 'econom':391 'economi':32 'element':52,77,85,293,365 'era':117 'etc':63,141 'exist':92,125,204,226,297 'featur':164 'field':354 'file':68,178,203,256,298,313,369,374,379 'fortress':139 'frontmatt':75,334,352 'genr':116,218 'histori':28,153 'identifi':229 'inhabit':162 'init':98 'interact':167,279 'kebab':187,265 'keep':357 'key':248 'link':312,355 'list':199 'locat':14,17,57,111,126,133,145,192,207,326,343,353,373 'magic':18,60,285,289,387 'magic-us':284 'make':300 'manag':50 'markdown':67 'md':188,266 'militari':392 'must':90 'name':135,186,264,318 'name-kebab':185,263 'notabl':163,196,331 'notable-charact':330 'overview':47,361 'physic':149 'polit':20,61,388 'practition':337 'prerequisit':86 'project':56,89,107 'prompt':239,382 'question':249 'read':113,122,215,223,295 'refer':80,208,275,308,327,336,368 'referenc':325 'references/location-template.md':180,370 'references/system-template.md':258,375 'references/world-element-types.md':235,380 'relev':154,238 'religion':31,390 'request':302 'root':108 'save':182,260 'section':362 'set':45 'skill':3,99 'skill-worldbuilding' 'social':393 'source-danjdewhurst' 'state':170 'status':321 'store':65 'stori':41,55,84,88,97,157,172 'story-init':96 'story.md':104,114,216 'system':19,21,30,59,128,213,227,231,243,270,282,290,335,378,385 'tabl':193,271 'tag':340 'technolog':29,62,389 'templat':371,376 'theme':220 'timelin':174 'tone':119 'topic-agent-skills' 'topic-claude-code' 'topic-claude-code-plugin' 'topic-codex' 'topic-copilot' 'topic-creative-writing' 'topic-cursor' 'topic-fiction' 'topic-gemini-cli' 'topic-markdown' 'topic-skill-md' 'topic-storytelling' 'type':137,232,252,319,386 'updat':190,268,291,310,315 'use':6,179,257,345 'user':9,286 'verifi':100,200 'via':94,329,338 'want':34 'wilder':140 'world':24,27,43,51,292,360 'worldbuild':1,46,71 'worldbuilding/_index.md':123,191,224,269,316,359 'worldbuilding/locations':184 'worldbuilding/systems':262 'write':176,254 'yaml':74","prices":[{"id":"d3d10d47-81c8-4c33-90f2-f0d65cadbeb9","listingId":"0e7bac84-fc26-405f-8f25-e2b1503c833b","amountUsd":"0","unit":"free","nativeCurrency":null,"nativeAmount":null,"chain":null,"payTo":null,"paymentMethod":"skill-free","isPrimary":true,"details":{"org":"danjdewhurst","category":"story-skills","install_from":"skills.sh"},"createdAt":"2026-04-18T23:06:00.251Z"}],"sources":[{"listingId":"0e7bac84-fc26-405f-8f25-e2b1503c833b","source":"github","sourceId":"danjdewhurst/story-skills/worldbuilding","sourceUrl":"https://github.com/danjdewhurst/story-skills/tree/main/skills/worldbuilding","isPrimary":false,"firstSeenAt":"2026-04-18T23:06:00.251Z","lastSeenAt":"2026-04-23T07:01:07.232Z"}],"details":{"listingId":"0e7bac84-fc26-405f-8f25-e2b1503c833b","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"danjdewhurst","slug":"worldbuilding","github":{"repo":"danjdewhurst/story-skills","stars":21,"topics":["agent-skills","claude-code","claude-code-plugin","codex","copilot","creative-writing","cursor","fiction","gemini-cli","markdown","skill-md","storytelling","windsurf","worldbuilding"],"license":"mit","html_url":"https://github.com/danjdewhurst/story-skills","pushed_at":"2026-02-13T22:11:25Z","description":"A Claude Code plugin for end-to-end story writing powered by markdown","skill_md_sha":"9ab563a0760c603efa2c32d273b636c26d40b275","skill_md_path":"skills/worldbuilding/SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/danjdewhurst/story-skills/tree/main/skills/worldbuilding"},"layout":"multi","source":"github","category":"story-skills","frontmatter":{"name":"worldbuilding","description":"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."},"skills_sh_url":"https://skills.sh/danjdewhurst/story-skills/worldbuilding"},"updatedAt":"2026-04-23T07:01:07.232Z"}}