worldbuilding SKILL.md skillA

worldbuilding from danjdewhurst/story-skills is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add danjdewhurst/story-skills/worldbuilding@git:20261102.3a5efee

Pins git:20261102.3a5efee in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
danjdewhurst/story-skills
Path
skills/worldbuilding/SKILL.md
Versions recorded
19
Latest version
git:20261102.3a5efee, committed Nov 2, 2026
First version recorded
Feb 12, 2026
Size
15,055 bytes
Repository stars
382
License
MIT

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", "map", "travel times", "routes", "calendar", "moons", "seasons", "naming language", "conlang names", "trade routes", "supply lines", "magic cost", "add a glossary term", "glossary", "invented word", or wants to develop any aspect of a story's world and setting. NOT for a glossary…

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# 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, and glossary terms for the world's invented words in `glossary/terms/`. 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
   - Routes to other locations: travel time in hours and mode (see `references/maps-and-routes.md`)
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add danjdewhurst/story-skills/worldbuilding@sha256:b2721885d7fde5a4

The line at the top of this page pins the label git:20261102.3a5efee, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_fuqrt2ztva2n7qx6.svg)](https://markdownregistry.com/a/art_fuqrt2ztva2n7qx6)

2 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 19 versions of this file, between Feb 12, 2026 and Nov 2, 2026, about one every 15 days.

versioncommittedcommitsizeaudit
git:20261102.3a5efee latest2026-11-02 3a5efee 15,055 BA view · diff
git:20261102.d6546022026-11-02 d654602 15,008 BA view · diff
git:20261027.d2c61882026-10-27 d2c6188 13,458 BA view · diff
git:20261014.4b8019d2026-10-14 4b8019d 13,266 BA view · diff
git:20261007.a8b3f012026-10-07 a8b3f01 13,125 BA view · diff
git:20261007.82fb53e2026-10-07 82fb53e 12,369 BA view · diff
git:20261007.b635ea32026-10-07 b635ea3 10,908 BA view · diff
git:20261007.9b5d2892026-10-07 9b5d289 10,908 BA view · diff
git:20261007.b5be7e62026-10-07 b5be7e6 10,761 BA view · diff
git:20260927.49fdaa92026-09-27 49fdaa9 9,657 BA view · diff
git:20260927.db107bd2026-09-27 db107bd 8,312 BA view · diff
git:20260925.15492b72026-09-25 15492b7 8,303 BA view · diff
git:20260924.d8aea7c2026-09-24 d8aea7c 7,945 BA view · diff
git:20260920.f6463082026-09-20 f646308 5,508 BA view · diff
git:20260915.8c380142026-09-15 8c38014 5,455 BA view · diff
git:20260607.04c83cd2026-06-07 04c83cd 4,878 BA view · diff
git:20260606.5ef15f82026-06-06 5ef15f8 3,689 BA view · diff
git:20260603.7a63f8a2026-06-03 7a63f8a 3,067 BA view · diff
git:20260212.9c72eb52026-02-12 9c72eb5 2,939 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (15055 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

danjdewhurst/story-skills · 382 stars · license MIT · pushed 2026-11-02 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_fuqrt2ztva2n7qx6
GET https://markdownregistry.com/api/v1/resolve?ref=danjdewhurst/story-skills/worldbuilding
GET https://markdownregistry.com/api/v1/blob/b2721885d7fde5a48e5aff9841ce36e72e68cc25fb437e48bb17dd2dafa5c5b4

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from danjdewhurst/story-skills

AGENTS.md AGENTS.md file
danjdewhurst/story-skills · AGENTS.md
git:20261101.ee29402 · audit B · 382 stars
CLAUDE.md CLAUDE.md file
danjdewhurst/story-skills · CLAUDE.md
git:20260901.e521c75 · audit B · 382 stars
adaptation SKILL.md skill
danjdewhurst/story-skills · skills/adaptation/SKILL.md · This skill should be used when the user asks to "make an audiobook", "narration script", "narrator", "ACX", "Findaway"…
git:20261014.4b8019d · audit A · 382 stars
chapter-writing SKILL.md skill
danjdewhurst/story-skills · skills/chapter-writing/SKILL.md · This skill should be used when the user asks to "write a chapter", "next chapter", "chapter outline", "draft chapter"…
git:20261014.4b8019d · audit A · 382 stars
character-management SKILL.md skill
danjdewhurst/story-skills · skills/character-management/SKILL.md · This skill should be used when the user asks to "create a character", "update a character", "add a character", "build a…
git:20261102.6098078 · audit A · 382 stars
discovery-drafting SKILL.md skill
danjdewhurst/story-skills · skills/discovery-drafting/SKILL.md · This skill should be used when the user asks about "pantsing", "discovery write", "write without an outline"…
git:20261014.4b8019d · audit A · 382 stars
editorial-review SKILL.md skill
danjdewhurst/story-skills · skills/editorial-review/SKILL.md · This skill should be used when the user asks for a "sensitivity reader", "authenticity reader", "cultural review", "is…
git:20261102.e86f75d · audit A · 382 stars
feedback-triage SKILL.md skill
danjdewhurst/story-skills · skills/feedback-triage/SKILL.md · This skill should be used when the user asks to "process beta reader feedback", "alpha reader feedback", "feedback…
git:20261014.2fdb6da · audit A · 382 stars
genre-craft SKILL.md skill
danjdewhurst/story-skills · skills/genre-craft/SKILL.md · This skill should be used when the user asks about "mystery", "fair play", "clue", "red herring", "romance beats"…
git:20261014.4b8019d · audit A · 382 stars
interactive-fiction SKILL.md skill
danjdewhurst/story-skills · skills/interactive-fiction/SKILL.md · This skill should be used when the user asks to "write a branching story", "interactive fiction", "choose your own…
git:20261014.4b8019d · audit A · 382 stars
line-editing SKILL.md skill
danjdewhurst/story-skills · skills/line-editing/SKILL.md · This skill should be used when the user asks to "line edit", "edit my prose", "polish this chapter", "tighten the…
git:20261014.4b8019d · audit A · 382 stars
plot-structure SKILL.md skill
danjdewhurst/story-skills · skills/plot-structure/SKILL.md · This skill should be used when the user asks to "create a plot arc", "story structure", "add a plot point", "story…
git:20261102.6098078 · audit A · 382 stars

Every file in danjdewhurst/story-skills

Other files named worldbuilding

worldbuilding SKILL.md skill
inkeep/open-knowledge · packages/server/assets/skills/packs/worldbuilding/SKILL.md · How to work in a Worldbuilding project (the `worldbuilding` starter pack): a fiction encyclopedia of characters…
git:20261014.adeb8b5 · audit A · 4,780 stars
worldbuilding SKILL.md skill
inkeep/open-knowledge-skills · skills/starter-packs/worldbuilding/worldbuilding/SKILL.md · How to work in a Worldbuilding project (the `worldbuilding` starter pack): a fiction encyclopedia of characters…
git:20261014.2bb8524 · audit A · 16 stars
worldbuilding SKILL.md skill
bs779517/story-skills · skills/worldbuilding/SKILL.md · This skill should be used when the user asks to "create a location", "add a location", "magic system", "political…
git:20260212.9c72eb5 · audit A · 8 stars

Browse by kind, by grade A, or by owner.