Three Scope Map skill

A Codex skill that creates runnable Vue projects with a 3D Earth, administrative maps, MapLibre overlays and contour terrain

  • 747 ★ on the repository
  • Last commit
Skill

Minimal access

Why this level

  • The skill only creates project files from templates and makes no network calls itself
  • The installer replaces the skill folder whole and keeps the old version in a backup folder
All reasons and checks

songsummer920-dazzle/three-scope-map-skill

Install

In your terminal, with SkillFoxx CLI

npx skillfoxx add skills/three-scope-map

Detects the agents on your machine, shows the access level and pins the version.

Other ways to install

Access and checks

How we review

Minimal accessThe tool runs nothing and makes no network calls.

  • The skill only creates project files from templates and makes no network calls itself
  • The installer replaces the skill folder whole and keeps the old version in a backup folder

This is third-party code. Review the repository files before installing.

What it does

Three Scope Map is a skill with ready Vue templates for geographic visualization: a Three.js Earth, administrative 3D maps, flat MapLibre maps, 2D plus 3D overlays and a separate contour mode built from elevation data. Version 3.0 includes a photographic Earth with a textured glass map, or a dot hologram Earth with a smooth glass map. The 2.0 style gives the classic Earth and classic map. The `python3 three-scope-map/scripts/install_skill.py` script puts the skill into `~/.codex/skills/three-scope-map` and, on upgrade, first backs the old version up to `~/.codex/skill-backups/`. `python3 three-scope-map/scripts/create_map_project.py ./my-map` creates a project: it copies the template and license files into an empty folder, and the user then runs `npm ci` and `npm run dev`. The agent gets a task such as "use three-scope-map, create a 3.0 entity Earth project, blue". It changes the style, the primary color as a HEX value and the region bounds while keeping data and navigation across levels: world, country, province, city, district.

Who it is for. Vue front-end developers who need a 3D Earth or a regional map in a dashboard, and people asking Codex to build such a screen.

Good fit when

  • A dashboard needs a landing page with a rotating Earth and a transition to a province map
  • A region map has to change, for example from Zhejiang to Jiangsu, keeping colors and interaction
  • A 3D map is needed over a flat MapLibre map, sharing its camera with the basemap
  • An independent terrain mode with contours from a real elevation model is required
  • The whole screen has to be recolored to one HEX value without losing materials

Not a fit when

  • You need a map for a paid service: the 3.0 license forbids embedding the templates in a platform with paid access without the author's written permission
  • The project is not written in Vue: the templates ship as Vue projects
  • You need a simple marker on a map: the skill targets showy scenes rather than a minimal map

Example request

Use three-scope-map to create a project with a 3.0 hologram Earth in blue tones, then add a map of Jiangsu province

Limitations

By default the skill installs into the Codex folder `~/.codex/skills`, and other agents need the `--source`, `--target` and `--backup-dir` parameters. The 3.0 license has a restriction: without prior written permission you may not embed the skill, templates or modified versions in platforms that charge for the map or Earth capability, while ordinary projects and custom development are allowed. Installing and creating a project needs Python 3.9 or newer, and the template builds through `npm`. Administrative levels depend on available data. Documentation and prompts are largely in Chinese.

How to disable. Delete the `~/.codex/skills/three-scope-map` folder. Backups of old versions sit separately in `~/.codex/skill-backups/`. A created project is an ordinary folder that you delete like any directory.

FAQ

How do I install the Three Scope Map skill?

Run `python3 three-scope-map/scripts/install_skill.py` from the repository root. The script places the skill in `~/.codex/skills/three-scope-map` and keeps a backup on upgrade.

How do I create a project with an Earth or a map?

Run `python3 three-scope-map/scripts/create_map_project.py ./my-map` in an empty folder, then `npm ci` and `npm run dev`. The script installs no packages and makes no network calls.

Which styles are available?

Style 2.0 gives the classic Earth and map. Version 3.0 has two variants: entity with a photographic Earth and a textured glass map, and hologram with a dot hologram Earth and a smooth glass map.

Can I change the color?

Yes. Give a color by name or HEX such as `#2AF7FF`: one primary color retints the Earth, maps, HUD and effects while materials and data stay.

What does the 3.0 license forbid?

Without the author's written permission you may not embed the skill, templates or modified versions in a platform that charges for Earth and map capabilities. Ordinary projects and custom development are allowed.

Discussion

No questions or reviews yet.

Skills

Three.js Awesome Graphics Skills

threejs-awesome-graphics-agent-skills

A three.js skills pack for great scene and game graphics: lighting, PBR, shaders, TSL and WebGPU, post-processing, particles

SkillMinimal access990Repository stars

Three.js Architecture Effects

threejs-architecture-effects

A skill building an orbitable Three.js building that assembles itself: brick, frame, procedural materials. The result is a working Vite and React site

SkillMinimal access729Repository stars

Eight skills for 3D and animated websites: three.js scenes from code, scroll films, transparent video, exploded machine views

SkillExtended access353Repository stars

A set of skills for Vue 3 development: Composition API practices, router, Pinia, testing, JSX, Options API and debugging

SkillMinimal access3.3KRepository stars

Ten reference skills for Three.js: scene setup, geometry, materials, lighting, shaders, animation and post-processing

SkillMinimal access4.2KRepository stars

A Three.js skill that guides an agent through 3D apps, configurators and games and orders models and materials from Mint MCP.

SkillExtended access126Repository stars

README in short

The README presents a skill with Vue templates for a 3D Earth and maps, warns about the 3.0 license restriction and shows animated style previews. It then covers installation and upgrade with `install_skill.py`, picking a style and color by phrase, creating a project with a script and example prompts for the agent. The end lists features, templates and integration.

README badge

Report a problem