skillZs
★ LIVE SKILL TAGS ★
>>> LIVE SKILLS INDEX <<<
* OPEN SOURCE *
NO LOGIN, NO TRACKING
※ REAL INSTALL DATA ※
← back to all skills
hopechen067/mapstage69 installs

mapstage

MapStage live tuner for map/globe projection, satellite, hypsometric relief, 3D terrain, region isolate, CSS color grade, and JSON presets.

How do I install this agent skill?

npx skills add https://github.com/hopechen067/mapstage --skill mapstage
view source ↗

Is this agent skill safe to install?

  • Gen Agent Trust Hubpass

    The MapStage skill is a comprehensive map visualization and styling tool. It provides a developer-focused environment for tuning map projections, terrain exaggeration, and geographic data layers. The skill relies on established third-party tile services and standard web libraries, and its use of dynamic evaluation is strictly scoped to loading map-related data files.

  • Socketwarn

    1 alert: gptAnomaly

  • Snykpass

    Risk: LOW · No issues

What does this agent skill do?

MapStage

Use this skill when building or tuning a MapStage scene: map/globe projection, satellite, hypsometric relief, Mapterhorn terrain, region isolate, CSS color grade, and JSON export.

When to use

  • Need a live MapStage tuner (map vs globe, satellite vs relief, isolate).
  • Need to lock paint / CSS / camera, then export JSON into another host.
  • Need tiered settlements (capital / large / medium / small / pass / station / ordos).

Do not use the tuner page as the final render host.

Modes

ModePurpose
Production stackEmbed MapStage in your app: optional satellite/raster + Mapterhorn DEM (encoding: 'terrarium') + hillshade + OpenFreeMap vector water + CSS filter + city extrusions. Drive look from exported JSON.
TunerHTTP page under tuner/ (or the public demo) for sliders, projection, isolate, preset load/export.

Workflow

  1. Open the tuner: public demo https://hopechen067.github.io/MapStage/ or cd tuner && python -m http.server and open the local URL printed in the terminal.
  2. Tiles: default EOX Sentinel-2 cloudless (on) + Mapterhorn (tuner/map-tiles.config.js). Override with gitignored map-tiles.config.local.js.
  3. Apply default preset tuner/preset-antique-default.json (same as tuner/presets/antique-default.json). Schema version 3.
  4. Adjust projection / satellite / relief / isolate / CSS / cities until the look locks.
  5. Export JSON (copy or download). Confirm version: 3 plus ui.projection, ui.showSatellite, ui.showRelief, ui.showCssFilter, isolate.
  6. Migrate those fields into the production MapStage scene (see references).
  7. In production: jumpTo camera; wait for idle; optionally pre-cache tiles. Avoid easeTo / flyTo for recorded frames.
  8. Always set DEM with encoding: 'terrarium'. Wrong encoding breaks hillshade/terrain.
  9. Final frames render from the production host — not from the tuner UI.

Hard rules

  • Tiles not bundled — MapStage fetches DEM and basemap at runtime from configured URLs only.
  • Only use basemap endpoints you are allowed to use — defaults are public demo tiles (EOX); swap via config when needed.
  • encoding: 'terrarium' on the terrain source — mandatory.
  • No easeTo / flyTo in recorded production paths; prefer jumpTo + idle.
  • Do not host final render on tuner.
  • Water on the public tuner is OpenFreeMap / OpenMapTiles vector layers (water / waterway). Export ui.showWater is always false (old GeoJSON overlay is off). Do not expect or commit tuner/assets/water-data.js.

Repo vs skill

git clone of this GitHub repo pulls the whole project. The agent skill is only mapstage/. Install that folder with npx skills add hopechen067/MapStage --skill mapstage -g or gh skill install hopechen067/MapStage mapstage --scope user, or copy it into the host skills directory and reload. Agents do not auto-discover mapstage/SKILL.md from a clone.

References

Agents

See agents/openai.yaml for display name / default prompt.

Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.

<a href="https://skillzs.dev/skills/hopechen067/mapstage/mapstage">View mapstage on skillZs</a>