worldbuilding

Creates and manages story world elements as cross-referenced markdown files with YAML frontmatter.

Updated Aug 28, 2026
One-click install
npx skills add https://github.com/miyake-san/sogo-agent-platform --skill worldbuilding-miyake-san
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: worldbuilding
Source: https://github.com/miyake-san/sogo-agent-platform/tree/main/skills/experimental/worldbuilding
Command: npx skills add https://github.com/miyake-san/sogo-agent-platform --skill worldbuilding-miyake-san

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Keeping track of locations, magic systems, factions, and artifacts across a long fiction project is error-prone, and inconsistencies between world elements and characters break immersion. This Skill structures every world element as a markdown file with YAML frontmatter so the setting stays consistent and cross-referenced. ## Core Features & Use Cases - Location Creation: Builds locations through guided conversation covering description, history, culture, and current state, saved to worldbuilding/locations/ using a template. - System Design: Develops magic, political, technology, religion, economic, military, social, and education systems with targeted prompts for rules, limitations, and societal impact. - Factions & Artifacts: Defines factions with power bases and conflicts, and artifacts with owners, functions, and history, all cross-linked to characters and locations. - Use Case: While drafting a fantasy novel, ask to add a magic system; the Skill walks through source, cost, and limits, writes worldbuilding/systems/ember-magic.md, updates the world index, and links practitioner characters. ## Quick Start Create a magic system for my story and save it to the worldbuilding directory with links to the characters who use it.

Frequently Asked Questions about worldbuilding

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create a magic system for my novel?

Ask to create a magic system and the Skill reads your story.md for genre context, then guides you through source, cost, limits, and social perception. It writes the result to worldbuilding/systems/ using the system template and updates the world index.

How do I add a location to my story world?

Request a new location and provide its name and type such as city, fortress, or wilderness. The Skill builds description, history, culture, and notable features through conversation, saves it to worldbuilding/locations/, and links notable characters.

Does the worldbuilding skill require the Story CLI?

No, the Story CLI is optional. When available it runs story reindex, links, and validate commands; otherwise the Skill falls back to the story-maintenance script or performs registry and backlink checks manually.

What types of world systems can I document?

The Skill supports magic, political, technology, religion, economic, military, social, and education systems. Each type has dedicated prompts in the world-element-types reference covering rules, limitations, practitioners, and societal impact.

What are the prerequisites for using this worldbuilding skill?

A story project must already exist, verified by the presence of story.md in the project root, typically created with the story-init skill. Without it, the Skill has no genre or tone context to build consistent world elements.