Openclaw Skills for migrating and standardizing briefing_package map systems by moving large YAML maps to maps/, wiring map_ref, and enabling map_config visuals.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install trpg-maps-update
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install trpg-maps-update using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is TRPG Maps Update?
Openclaw Skills helps you update an existing briefing_package map system without breaking the project structure. It turns scattered or oversized map YAML into a clean, scalable setup by moving large maps into maps/, converting scene YAML from initial_map to map_ref, and preserving a single source of truth for map data.
It also standardizes visual map metadata in config.yaml through map_config, making it easier to render dungeon, world, tactical, or starmap panels consistently. Openclaw Skills is ideal when a TRPG briefing_package needs a map fix, a map migration, or a token-efficient YAML refactor.
TRPG Maps Update Use Cases
- Fixing a broken or incomplete map system in an existing briefing_package.
- Migrating large map YAML from
data/intomaps/. - Replacing
initial_mapwithmap_refin oversized scene YAML files. - Adding or refining
map_configinconfig.yamlfor visual map rendering. - Cleaning legacy
data/map copies after migration to reduce token waste. - Updating multiple scenes or maps in one batch.
How TRPG Maps Update Works
- Inspect the briefing_package for scene YAML,
data/,maps/, andconfig.yaml. - Identify map definitions, legacy exports, and oversized maps (roughly 80+ lines).
- Create
maps/if missing, then move canonical large map YAML fromdata/intomaps/. - Remove the obsolete
data/copy so the package keeps one active map source only. - Change scene YAML from
initial_maptomap_ref: "maps/<file>"for migrated maps. - Add or refine
map_configinconfig.yamlwhen a visual map panel is needed. - Validate that maps stay as YAML with
nodes,edges, andregions, and leave external legacy map exports untouched.
TRPG Maps Update Setup
Openclaw Skills is file-structure based, so there is no runtime package to install. Apply it directly inside the target briefing_package.
- Create the canonical map directory.
mkdir -p briefing_package/maps
- Inspect candidate map files before migration.
find briefing_package/data -maxdepth 1 -name '*.yaml'
- Move large map YAML into
maps/and delete the legacydata/copy after confirmation.
mv briefing_package/data/old_map.yaml briefing_package/maps/old_map.yaml
rm briefing_package/data/old_map.yaml
- Update oversized scene YAML references to
map_ref.
map_ref: "maps/old_map"
- Optionally add
map_configtoconfig.yamlfor visual map panels.
map_config:
type: "dungeon"
title: "Dungeon Map"
node_types:
- name: "Entrance"
color: "#22c55e"
edge_types:
- name: "Corridor"
color: "#6b7280"
Small maps under 80 lines may remain inline as initial_map; only migrate oversized or shared maps into maps/.
TRPG Maps Update Data Schema & Taxonomy
Directory layout
| Path | Purpose | Notes |
|---|---|---|
briefing_package/maps/*.yaml |
Canonical large map storage | Use for 80+ line maps; loaded at game start, not injected every turn |
briefing_package/...scene YAML |
Scene-level reference files | Replace initial_map with map_ref for migrated maps |
briefing_package/config.yaml |
Map presentation metadata | Optional map_config block controls type, title, node colors, and edge colors |
briefing_package/data/ |
Legacy staging area | Remove active map YAML after migration to avoid duplicated sources |
Map YAML schema
nodes: list of node objects withid,label,x,y,type, andexplorededges: list of graph links withfrom,to, andtyperegions: list of grouped areas withname,color, andnodes
map_config taxonomy
type:starmap,dungeon,tactical, orworldtitle: display title for the map panelnode_types: named node labels with colorsedge_types: named connection labels with colors
Rules of ownership
- Small maps under ~80 lines may remain inline as
initial_map - Large maps should live in
maps/ - Keep one authoritative copy of each active YAML map
TRPG Maps Update Advanced Features
- Batch migration across multiple scenes and map files, reducing manual refactors.
- Token optimization by relocating large YAML out of
data/and intomaps/. - Visual panel support via
map_configfor dungeon, world, tactical, or starmap layouts. - Structured graph modeling with
nodes,edges, andregionsinstead of image-based or ASCII maps. - Safe legacy handling that preserves already-integrated external export files while updating only the authoritative briefing_package sources.
SKILL.md
Loading
Related Openclaw Skills
TRPG YAML to SVG Maps
Openclaw Skills turns TRPG YAML map definitions into clean, readable SVG visual maps without modifying the source YAML.
Craft MCP v2 Integration
An AI coding agent skill to create, read, and structure documents, tasks, and whiteboards via the unified Craft MCP v2 API.
PuzzleTide Crossword
PuzzleTide Crossword helps Openclaw Skills generate valid, numbered crossword grids locally from custom clues, themes, or word banks.
PuzzleTide Agent Evals
Openclaw Skills for generating, running, and grading reproducible puzzle benchmarks that verify LLM and agent reasoning locally.
TRPG Markdown to PDF
Converts TRPG markdown source files into polished, print-ready PDFs without modifying the originals.
TRPG Public Intro Writer
Openclaw Skills turns TRPG source materials into a polished, player-facing introduction that makes people want to try the game.
Featured*
