Getting it into your agent
One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.
npx skills add danjdewhurst/story-skills --skill worldbuildinggit clone --depth 1 https://github.com/danjdewhurst/story-skillsWrote this? Show the measurements
A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.
[](https://agentmods.dev/skills/danjdewhurst/story-skills/worldbuilding)<a href="https://agentmods.dev/skills/danjdewhurst/story-skills/worldbuilding"><img src="https://agentmods.dev/badge/skills/danjdewhurst/story-skills/worldbuilding/github.svg" alt="Measured on agentmods" height="20"></a>Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.
<a href="https://agentmods.dev/skills/danjdewhurst/story-skills/worldbuilding"><img src="https://agentmods.dev/badge/skills/danjdewhurst/story-skills/worldbuilding.svg" alt="Reviewed on agentmods" width="80" height="20"></a>- Socket pass
- Snyk pass
- NVIDIA SkillSpector pass
What it costs to keep this loaded
Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.
| Model | Per session | Once invoked |
|---|---|---|
| Fable 5.1 | $0.00141 | $0.03146 |
| Opus 5.5 | $0.00056 | $0.01258 |
| Sonnet 5.5 | $0.00028 | $0.00629 |
| Haiku 4.5 | $0.00014 | $0.00315 |
Grade A, and why
worldbuilding scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 11d ago.
A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.
Nothing flagged
None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.
How it starts
The opening of the file, as written. The whole thing — 174 lines — stays where its author put it; the contents beside it link to each section on GitHub.
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
- Read
story.mdfor genre, era, and tone context - Read
worldbuilding/_index.mdfor 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
- Routes to other locations: travel time in hours and mode (see
references/maps-and-routes.md) - Pronunciation, if the name is invented or easily misread (
pronunciation: "KEL-ah-mar")
- Before settling an invented name, run
story names '{Candidate}'to catch clashes and look-alikes (seereferences/naming-languages.md) - Create it with
story add location '{Location Name}' --type '{type}'when the CLI is available (add--region,--population,--controlled-by, and--characteras known); it writesworldbuilding/locations/{name-kebab}.mdand lists it inworldbuilding/_index.md. Then fill the body fromreferences/location-template.md - Without the CLI, write the file from
references/location-template.mdtoworldbuilding/locations/{name-kebab}.md - Leave the locations table in
worldbuilding/_index.mdtostory reindex ., even without the CLI; never add a row by hand - If notable characters are listed, verify those character files exist and add this location's kebab-case identifier to each character file's
locationsfrontmatter list - When CLI access is available, run
story reindex .,story wordcount . --write, andstory check .
What ships with it
9 files beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.
- references/artifact-template.md 663 B
- references/calendars.md 5.9 KB
- references/economy-logistics.md 3.1 KB
- references/faction-template.md 644 B
- references/location-template.md 2.1 KB
- references/maps-and-routes.md 3.8 KB
- references/naming-languages.md 3.4 KB
- references/system-template.md 1008 B
- references/world-element-types.md 2.7 KB
What this file has done since we first saw it
Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.
- 11d ago Changed 44fccc0b3129
- 18d ago Changed · +12 lines · +26 tokens per session 0192c7900cf0
- 19d ago Changed · +4 lines c6eb4f26bc10
- 28d ago Changed · +22 lines 15224b183a77
- 1mo ago Changed c9733ae9e26d
- 1mo ago Changed · +30 lines · +44 tokens per session 2ba4155efa86
- 1mo ago Changed 59527be0eb77
- 1mo ago Changed · +12 lines 2b4335beadb9
- 1mo ago First seen · 94 lines · 71 tokens per session scan A 6085390c9303
worldbuilding is a skill published in the GitHub repository danjdewhurst/story-skills (352 stars, last pushed 5d ago), licensed MIT. It adds 141 tokens to every session and 3,146 once invoked, about $0.0006 per session on Opus 5.5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.
Other skills, from other repositories
alive:demo
Generate a believable, lived-in ALIVE world from a free-text persona description (custom path) or a deterministic sandbox preset. Routes the create/list/activate/deactivate/delete/status surface and orchestrates the 5-stage subagent generation pipeline.
alive:system-upgrade
Upgrade ALIVE to the current version. Handles v1/v2/v3.x source states, multi-surface aware (alive-mcp / Hermes / Codex), retroactive version detection, partial-failure resume, dry-run previews, and rollback inspection.
alive:save
The human wants to checkpoint. Or: the stash has grown heavy — 5+ items, 30+ minutes, a natural pause in the work. The squirrel doesn't decide when to save. It surfaces the need and lets the human pull the trigger. Runs the full save protocol: confirms stash, writes log, updates state, generates projections…
alive:system-cleanup
The world feels messy. Stale tasks, orphan folders, v2 remnants, unsaved sessions — entropy is accumulating and needs to be addressed before it compounds. Scans across all walnuts, then surfaces issues one at a time.
alive:create-walnut
Something new is emerging. A venture, an experiment, a person entering the orbit, a life area getting serious. It needs its own walnut — its own identity, history, and future. Scaffolds the full structure, maps existing context sources, and optionally migrates files across.
alive:session-history
Revive sessions (quick or heavy), browse, and search — 'what happened recently?', 'find the session where we discussed X', 'revive yesterday's session'. For single-session recall and multi-session browsing. If the human needs to merge multiple sessions into one working context or detect conflicts between parallel…