| name | create-world |
| description | Create or refine canonical webtoon worldbuilding files in world/ for rules, institutions, eras, technologies, cultures, timelines, social systems, or persistent world state. Use when defining how the world works, how that rule creates story pressure, how readers can understand it visually, or which facts must remain consistent across episodes; use $create-background separately for a place and its multi-angle image assets. |
Create World
Create world canon that can be shown through behavior, environment, costume, props, and consequences. Keep location visual production in $create-background.
Follow the project runtime in AGENTS.md: call load_workspace_dependencies, set PYTHON, and run the writer through locked uv run.
Workflow
- Read
project.md, world/_template.md, existing world files, and linked plot, character, background, material, MacGuffin, continuity, episode, and style sources.
- Choose a category such as
rule, institution, timeline, technology, culture, economy, politics, magic, or social-system.
- Separate confirmed facts from proposals. Define scope, exceptions, enforcement, cost, failure mode, and who benefits or suffers.
- Define reader-visible evidence: architecture, costume, gesture, ritual, interface, prop, dialogue behavior, or consequence. Do not depend on exposition alone.
- Define story pressure and continuity invariants. Link only real entity IDs and episode IDs.
- Ask for confirmation before writing new canon.
Write
Prepare reviewed UTF-8 JSON matching world/_template.md, with body fields definition, visible_evidence, story_pressure, and continuity.
uv run --frozen --python "$PYTHON" python .agents/skills/create-world/scripts/write_world.py \
--project-root . --input /absolute/path/to/world.json
The writer validates the slug, ID, status, arrays, and dates; writes world/<slug>.md atomically; and refuses overwrite unless --force is explicit. For revisions, patch minimally, preserve created, update updated, and propagate changed facts to affected plot, background, character, episode, and continuity sources.
Completion Gate
Require a precise definition, visible evidence, story pressure, exceptions/cost, continuity facts, and no contradiction with existing canon. Do not claim a place has a reusable visual set until $create-background approves it.
