regions

Define and validate adjacency-compliant region schemas with coordinates and metadata.

14|7|Updated Apr 25, 2026
One-click install
npx skills add https://github.com/nikolaj-lat/World-Puppeteer --skill regions
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: regions
Source: https://github.com/nikolaj-lat/World-Puppeteer/tree/main/.claude/skills/regions
Command: npx skills add https://github.com/nikolaj-lat/World-Puppeteer --skill regions

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Regions provide a structured way to design, describe, and validate geographic areas in a world, ensuring adjacency, consistent coordinates, and coherent metadata across realms.

Core Features & Use Cases

  • Define region schemas with required fields (name, basicInfo, x, y, realm, imageUrl) and optional flags (known, factions).
  • Enforce adjacency rules so regions in a realm form a connected grid and share edges (not diagonals).
  • Provide references and guidance for realms, locations, and world layout to support map design and quest planning.

Quick Start

Create a new region entry in tabs/regions.json following the required fields and adjacency rules.

Frequently Asked Questions about regions

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

FAQPage Schema
How do I design world regions with consistent coordinates and adjacency rules?

World region design requires a minimal schema with fields like name, x, y, and realm, enforcing edge-sharing adjacency to form a connected grid. This ensures coherent metadata across multiple realms and plains.

What is region validation in worldbuilding and how does it work?

Region validation checks that geographic areas in a realm follow adjacency rules, sharing edges rather than diagonals. It enforces a minimal schema for required fields and optional flags like factions and known status.

How do I map a connected grid of regions across multiple realms?

Mapping regions across realms involves assigning coordinate values (x, y) and a realm identifier to each entry. The grid enforces edge-sharing adjacency, ensuring all regions within a realm connect without diagonal gaps.

Can I include optional metadata like factions when defining world regions?

Yes, defining world regions supports optional metadata flags such as factions and known status alongside required fields like basicInfo, x, y, realm, and imageUrl. This allows flexible lore integration without breaking the schema.

What are the limitations of diagonal adjacency in realm grid planning?

Diagonal adjacency is not permitted in realm grid planning; regions must share edges to form a connected grid. This constraint ensures consistent coordinate planning and valid map layouts across all defined realms.

What's the best way to start planning region metadata for a new worldbuilding realm?

The best way to start planning region metadata is creating a new region entry following the required fields schema, ensuring you include name, basicInfo, x, y, realm, and imageUrl for valid coordinate planning.