maps

Generate an HTML map with region grids and plotted locations from JSON world data.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps worldbuilders quickly visualize their imagined worlds by turning configuration data into a rendered map, enabling clear geographic planning and communication.

Core Features & Use Cases

  • HTML map rendering: produce a self-contained visual map from settings, realms, regions, and locations.
  • Grid-based regions, plotted locations: squares denote regions and circles denote locations, with hover tooltips for details.
  • Use Case: when designing a world, quickly preview realm layouts and location placements to inform storytelling, quest design, and world coherence.

Quick Start

Provide your world config data and run the Maps skill to generate stuff/world-map.html.

Frequently Asked Questions about maps

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

FAQPage Schema
How do I generate an HTML world map from JSON configuration data?

To generate an HTML world map from JSON configuration data, you provide your settings, realms, regions, and locations JSON files to the Maps skill, which reads the sources and renders a self-contained visual map at stuff/world-map.html.

What JSON files do I need to prepare for world map visualization?

For world map visualization, you need to prepare four JSON files: tabs/settings.json, tabs/realms.json, tabs/regions.json, and tabs/locations.json, which the Maps skill reads to render realm layouts and plotted locations.

Does the generated world map support interactive location details?

Yes, the generated world map supports interactive location details by using grid-based squares to denote regions and circles for locations, complete with hover tooltips that display specific details about each plotted point.

Can I use this map rendering for game design and storytelling planning?

You can use this map rendering for game design and storytelling planning because it provides a spatial overview of realm layouts and location placements, helping you visualize world coherence and inform quest design.

What is the best way to visualize realm layouts and location placements for worldbuilding?

The best way to visualize realm layouts and location placements for worldbuilding is to use a skill that turns your world configuration data into a rendered HTML map, enabling clear geographic planning and communication through visual grids and plotted points.

Do I need any external dependencies to render a visual map from world data?

No, you do not need any external dependencies to render a visual map from world data, as the Maps skill operates independently without dependencies and produces a self-contained HTML file for direct geographic visualization.