Agent skill

Projection Selection

by zzhonglei in zzhonglei/GeoCode-Release

Select an appropriate projected coordinate system for geographic data analysis or cartographic tasks.

MITAuto-check passedData & Analytics

Install Projection Selection

skills CLI
$ npx skills add zzhonglei/GeoCode-Release --skill projection-selection -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install zzhonglei/GeoCode-Release projection-selection --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/zzhonglei/GeoCode-Release.git skills-src && mkdir -p .claude/skills && cp -r skills-src/contributions/projection-selection/skill .claude/skills/projection-selection && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
projection-selection
GitHub stars
189
Token cost
~4.1k tokens
SKILL.md length
1,409 words
Files
2 (incl. references)
Skills in repo
7
Repo updated
First seen
Licence
MIT

At a glance

Select an appropriate projected coordinate system for geographic data analysis or cartographic tasks.

  • Works in 4 steps: Cylindrical Projections → Conic Projections → Azimuthal Projections → …
  • Tasks that involve Data analysis
  • SKILL.md covers I. Distortion Properties of…, II. Projection Families and…, III. Differences in Projection… and IV. Common Scenario Quick…, plus 1 more section
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Projection Selection is an agent skill from zzhonglei/GeoCode-Release. Select an appropriate projected coordinate system for geographic data analysis or cartographic tasks. Consult this skill when you need to determine which projection to use. Before using this skill, you MUST first identify the latitude/longitude extent of the study area, as key parameters — such as zone numbers, standard parallels, and central meridians — all depend on its location and extent. To obtain the precise extent, you can search for relevant reference materials or create a boundary vector file (e.g…

Its SKILL.md is about 4.1k tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files, including reference files (for example `references/中国制图投影坐标系规范.md`).

It sits in Data & Analytics, covering Data analysis. The repository describes itself as: A desktop AI assistant for geoscience data processing. The licence is MIT.

When your agent uses it

  • Tasks that involve Data analysis

Example prompts

  • “/projection-selection”

Workflow steps

4 steps, taken from the step headings in SKILL.md.

  1. Cylindrical Projections
  2. Conic Projections
  3. Azimuthal Projections
  4. Pseudocylindrical Projections

What it can do on your machine

Read from SKILL.md and the folder at commit 6e3534f. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Projection Selection loads about 4.1k tokens when it runs, and up to ~6.4k if it reads all its reference files. Until then it costs about 143 tokens; SKILL.md has 1,409 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~143
When it runs · the whole SKILL.md, loaded when a task matches
~4.1k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~6.4k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from zzhonglei/GeoCode-Release at commit 6e3534f, republished under its MIT licence (© zzhonglei). 1,409 words, ~4,058 tokens.

Download SKILL.mdSave it as .claude/skills/projection-selection/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
projection-selection
description
Select an appropriate projected coordinate system for geographic data analysis or cartographic tasks. Consult this skill when you need to determine which projection to use. Before using this skill, you MUST first identify the latitude/longitude extent of the study area, as key parameters — such as zone numbers, standard parallels, and central meridians — all depend on its location and extent. To obtain the precise extent, you can search for relevant reference materials or create a boundary vector file (e.g., .shp, .geojson) for the study area.

This skill is a built-in skill of GeoAgent. Please read all the following content carefully and strictly follow the guidelines during task execution.

Projection Coordinate System Selection Guide

This skill provides a comprehensive knowledge framework for selecting projected coordinate systems, helping you make sound projection choices when faced with geographic data analysis or cartographic tasks.

Prerequisite: You can only begin selecting a projection once the study area's latitude/longitude extent is known. Many projection parameters (such as UTM/Gauss-Krüger zone numbers, conic projection standard parallels, central meridians, etc.) depend on the specific location and extent of the study area — without this information, a correct projection choice cannot be made.


I. Distortion Properties of Projections

This is the first decision dimension for projection selection — what geometric property does your task need to preserve?

Four Types of Distortion
Distortion PropertyWhat It PreservesWhat It SacrificesTypical Use Cases
ConformalLocal shapes and anglesArea distortion (high-latitude regions are enlarged)Navigation, weather maps, ocean current maps, wind field maps, any direction-critical scenario
Equal-areaCorrect area proportions for any regionShape distortion (regions far from standard lines are compressed or stretched)Population density, land use, precipitation distribution, any statistical thematic map requiring area comparison
EquidistantDistances from a given point or lineBoth angles and areas are distortedDistance analysis from a city, communication coverage, airline distance maps
CompromiseNothing strictly, but overall visual balanceAll properties have slight distortionGeneral-purpose display maps, educational maps, world maps in publications
Key Principles of Distortion
  1. Conformal and equal-area are mutually exclusive — A projection cannot be both conformal and equal-area simultaneously; this is a mathematically proven theorem.
  2. Distortion increases with distance — The farther from where the projection surface is tangent/secant to the sphere (standard lines), the greater the distortion.
  3. Negligible at small scales — When the mapping area is sufficiently small (e.g., a single city), differences between projections are negligible.

II. Projection Families and Applicable Ranges

This is the second decision dimension for projection selection — how large is your map's coverage, what shape is the region, and at what latitude is it located?

Classification by Projection Surface

Projections are classified into families by the type of geometric surface, each naturally suited to different regional shapes:

1. Cylindrical Projections

Project the earth onto a cylinder wrapped around it, then unroll.

  • Characteristics: Meridians are equally spaced parallel straight lines; parallels are also parallel straight lines
  • Best suited for: Regions near the equator, extending in the east-west direction
  • Distortion pattern: Minimum along the equator (or standard parallels), increasing toward the poles

Common projections:

Projection NameDistortion PropertyUse Cases
MercatorConformalMarine navigation, web maps (not suitable for global area comparison)
Transverse MercatorConformalNorth-south elongated small regions (basis of UTM, Gauss-Krüger)
Equal-Area CylindricalEqual-areaArea statistics near the equator
Plate Carrée (Equidistant Cylindrical)Equidistant (along meridians)Quick display, default coordinates for data exchange
2. Conic Projections

Project the earth onto a cone placed over it, then unroll.

  • Characteristics: Meridians are straight lines radiating from the apex; parallels are concentric circular arcs
  • Best suited for: Mid-latitude (30°–60°) regions extending in the east-west direction
  • Distortion pattern: Minimum along the standard parallels, increasing to the north and south
  • Key parameter: Two standard parallels, typically placed at approximately 1/6 inward from the north and south boundaries of the mapping area

Common projections:

Projection NameDistortion PropertyUse Cases
Lambert Conformal ConicConformalMid-latitude country/continent mapping (weather, aviation)
Albers Equal-Area ConicEqual-areaStatistical thematic maps for mid-latitude countries/continents
Equidistant ConicEquidistantDistance measurement in mid-latitude regions
3. Azimuthal Projections

Project the earth onto a plane tangent to a single point.

  • Characteristics: Radial pattern from the tangent point; azimuth angles from the center point are always correct
  • Best suited for: Polar regions, or circular areas centered on a specific point
  • Distortion pattern: Increases outward from the tangent point

Common projections:

Projection NameDistortion PropertyUse Cases
StereographicConformalPolar mapping, precise local area mapping
Lambert Azimuthal Equal-AreaEqual-areaArea statistics centered on a point (e.g., continental maps)
Azimuthal EquidistantEquidistant (from center point)Distance display from a city, airline route maps
4. Pseudocylindrical Projections

Variants of cylindrical projections where parallels remain straight lines but meridians curve.

  • Characteristics: Overall oval or similar shape, visually close to the earth's "natural feel"
  • Best suited for: World maps
  • Distortion pattern: Most accurate near the central meridian and equator, increasing toward edges

Common projections:

Projection NameDistortion PropertyUse Cases
MollweideEqual-areaGlobal distribution area statistics thematic maps
RobinsonCompromiseGeneral-purpose global display maps
SinusoidalEqual-areaGlobal area statistics for low-latitude regions
Natural EarthCompromiseAesthetically pleasing global display maps
Equal EarthEqual-areaAesthetically balanced global equal-area thematic maps (recommended)

III. Differences in Projection Selection for GIS Analysis vs. Cartography

Projection selection is not purely a technical issue — it also depends on the purpose of what you're doing. GIS analysis and cartographic mapping have different logics for projection requirements.

Important: A single task can use multiple projections. Within the same project, the GIS analysis phase and the final cartographic phase can use entirely different projections. For example: use an equal-area projection for area statistical analysis, then use a projection conforming to local cartographic standards for the final map output. Don't try to use a single projection for all stages — instead, choose the most suitable projection for each stage based on its purpose.

Show full SKILL.md (526 more words)Show less
GIS Analysis: Projection Follows the Task

In GIS spatial analysis, projection selection should fully serve the analytical task's requirements:

Analysis TaskProperty to PreserveProjection Type to UseExample
Area calculation, density analysisAreaEqual-area projectionCalculate forest cover area by country
Distance/buffer analysisDistanceEquidistant projection or UTM/Gauss-KrügerCalculate distance from city to coastline
Direction/angle analysisAnglesConformal projectionAnalyze wind directions, ocean currents
Shape analysisLocal shapeConformal projectionTerrain feature identification
Small-area comprehensive analysisBalanced propertiesUTM / Gauss-KrügerMulti-dimensional spatial analysis at city level

Principle: Accuracy of analytical results comes first; visual aesthetics don't matter.

Cartography: Projection Selection Requires Comprehensive Consideration

Projection selection in cartographic mapping is more complex, requiring simultaneous consideration of the following factors:

1. Local Cartographic Standards

Many countries and regions have official cartographic projection standards. When mapping a specific area, local standards should take priority:

  • National topographic base maps usually have legally mandated projections (e.g., China uses the Gauss-Krüger projection)
  • International publications may require specific projections
  • Industry standards may specify projections (e.g., aviation charts use Lambert Conformal Conic)

2. Thematic Map Subject Characteristics

Projection selection should serve thematic expression:

  • Themes showing area comparison (population density, land use) → Must use equal-area projection; otherwise area comparison will be distorted
  • Themes showing direction/flow (wind fields, ocean currents, migration routes) → Prefer conformal projection
  • Themes showing distance relationships (service coverage, radiation circles) → Prefer equidistant projection
  • General display themes → Compromise projection is sufficient

3. Comprehensive Trade-offs

When standard requirements and thematic needs conflict, cartographic standards generally take priority — because standards ensure data comparability and interoperability. When there are no explicit standard constraints, thematic expression needs take precedence.

Note: When standards and thematic needs are hard to reconcile, proactively ask the user: Do they need to follow specific cartographic standards? Do they prioritize accurate thematic data expression or overall visual aesthetics? Use this as the basis for projection selection decisions.


IV. Common Scenario Quick Reference Table

The following lists recommended projection schemes for high-frequency mapping scenarios as a quick reference:

World Maps
ScenarioRecommended ProjectionRationale
Global statistical thematic maps (population, climate, etc.)Equal Earth / MollweideEqual-area, ensures accurate area comparison
Global general display mapsRobinson / Natural EarthCompromise, visually natural and balanced
Global ocean/route mapsMercatorConformal, directions and routes are correct
Continental / Large Regional Maps
ScenarioRecommended ProjectionRationale
Continental equal-area thematic mapsAlbers Equal-Area Conic / Lambert Azimuthal Equal-AreaEqual-area, suitable for large mid-latitude areas
Continental conformal mappingLambert Conformal ConicConformal, accurate shapes
Polar regionsStereographic (conformal) / Lambert Azimuthal Equal-Area (equal-area)Azimuthal projections are naturally suited for poles
National-Level Maps
ScenarioRecommended ProjectionRationale
Mid-latitude country thematic maps (E-W extent)Albers Equal-Area Conic / Lambert Conformal ConicConic projections suit mid-latitude E-W regions
Equatorial country thematic mapsMercator / Cylindrical Equal-AreaCylindrical projections suit equatorial regions
North-south elongated countries (e.g., Chile)Transverse MercatorTransverse cylindrical suits N-S elongated regions
Small-Area Maps
ScenarioRecommended ProjectionRationale
City-level precise mapping/analysisUTM / Gauss-KrügerAll types of distortion are negligible at small scales
Distance display centered on a pointAzimuthal EquidistantAccurate distances from center point

Reference Documents

FileWhen to Read
references/中国制图投影坐标系规范.mdWhen the task involves any part of China. — read it before selecting a projection for China.

© zzhonglei, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 1 other file (references) in contributions/projection-selection/skill of zzhonglei/GeoCode-Release.

  • SKILL.md
  • references/中国制图投影坐标系规范.md

Open the folder on GitHubat commit 6e3534f

Compare with similar skills

Projection Selection next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Projection Selection compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Projection Selection this skillzzhonglei/GeoCode-Release189—~4.1kAutomated safety check: PassMIT
Exploratory Data Analysisspacering-net/codeg3.9k14 repos~3.6kAutomated safety check: PassMIT
Excel and CSV Data Analysisbytedance/deer-flow84k4 repos~2.2kAutomated safety check: PassMIT
Exploratory Data AnalysisOleafly/Oleafly2122 repos~3.4kAutomated safety check: NotesMIT
Pandas ProJeffallan/claude-skills12k1 repos~1.5kAutomated safety check: PassMIT
Python Executorcortega26/chile-hub1132 repos~1.5kAutomated safety check: PassMIT

Similar skills

  • Exploratory Data Analysis

    spacering-net/codeg

    Perform comprehensive exploratory data analysis on scientific data files across 200+ file formats.

    3.9k GitHub starsUsed in 14 repos~3.6k tokens
    Data & AnalyticsAuto-check passed
  • Excel and CSV Data Analysis

    bytedance/deer-flow

    Analyzes uploaded Excel and CSV files with SQL through DuckDB, producing schema inspections, statistical summaries and exports to CSV, JSON or Markdown.

    84k GitHub starsUsed in 4 repos~2.2k tokens
    Data & AnalyticsAuto-check passed
  • Perform bounded, local exploratory analysis of explicitly supported scientific files.

    212 GitHub starsUsed in 2 repos~3.4k tokens
    Data & AnalyticsAuto-check: notes
  • Pandas Pro

    Jeffallan/claude-skills

    Handles pandas DataFrame work: cleaning, merging, groupby aggregation, pivots, time-series resampling and memory tuning, with checks on dtypes, shapes and nulls.

    12k GitHub starsUsed in 1 repo~1.5k tokens
    Data & AnalyticsAuto-check passed
  • Python Executor

    cortega26/chile-hub

    Execute Python code in a safe sandboxed environment via [inference.sh](https://inference.sh).

    113 GitHub starsUsed in 2 repos~1.5k tokens
    Data & AnalyticsAuto-check passed
  • Agentic Kaggle Workflow

    FrankS-IntelLab/agentic-kaggle-skill

    Takes a Kaggle competition from rules and validation design through baselines, ensembling and notebook architecture to a scored submission.

    188 GitHub stars~4k tokensUpdated 3 mo ago
    Data & AnalyticsAuto-check passed

More from zzhonglei/GeoCode-Release

  • Thematic Map

    zzhonglei/GeoCode-Release

    Create well-designed maps that follow standard cartographic conventions.

    189 GitHub stars~3.1k tokensUpdated 6 days ago
    Auto-check passed
  • XLSX

    zzhonglei/GeoCode-Release

    Create, edit, analyze, or convert Excel spreadsheets (.xlsx, .xlsm) where the workbook file is the primary deliverable.

    189 GitHub stars~3.1k tokensUpdated 6 days ago
    Auto-check passed
  • China Statistics Data

    zzhonglei/GeoCode-Release

    Find, download, and prepare official thematic statistics from the National Bureau of Statistics of China.

    189 GitHub stars~2.7k tokensUpdated 6 days ago
    Auto-check passed
  • Gee Scripting

    zzhonglei/GeoCode-Release

    GEE scripting and remote sensing analysis workflow guide. An agent skill from zzhonglei/GeoCode-Release.

    189 GitHub stars~1.6k tokensUpdated 6 days ago
    Auto-check passed
  • China Admin Boundaries

    zzhonglei/GeoCode-Release

    Official, standards-compliant vector boundaries of China's administrative divisions — province, city and county polygons.

    189 GitHub stars~434 tokensUpdated 6 days ago
    Auto-check passed
  • Hello Geocode

    zzhonglei/GeoCode-Release

    Sample skill verifying the GeoCode skill store pipeline end-to-end.

    189 GitHub stars~297 tokensUpdated 6 days ago
    Auto-check passed

Questions about Projection Selection

What does Projection Selection do?

Select an appropriate projected coordinate system for geographic data analysis or cartographic tasks. Projection Selection is an agent skill from zzhonglei/GeoCode-Release. Select an appropriate projected coordinate system for geographic data analysis or cartographic tasks.

When should I use Projection Selection?

Projection Selection fits situations like: tasks that involve Data analysis.

How do I install Projection Selection in Claude Code?

Run `npx skills add zzhonglei/GeoCode-Release --skill projection-selection -a claude-code`. Or copy the skill folder (contributions/projection-selection/skill in zzhonglei/GeoCode-Release) into .claude/skills/projection-selection in your project. Claude Code loads it when a task matches its description.

How do I install Projection Selection in Codex?

Run `npx skills add zzhonglei/GeoCode-Release --skill projection-selection -a codex`. Or copy the skill folder (contributions/projection-selection/skill in zzhonglei/GeoCode-Release) into .agents/skills/projection-selection in your project. Codex loads it when a task matches its description.

Can I use Projection Selection in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add zzhonglei/GeoCode-Release --skill projection-selection -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/projection-selection, .gemini/skills/projection-selection, .github/skills/projection-selection and .opencode/skills/projection-selection in your project.

What does Projection Selection need to run?

SKILL.md names no scripts, command-line tools or credentials: Projection Selection is instructions for the agent only.

Does Projection Selection access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Projection Selection safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Projection Selection use?

Projection Selection is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Projection Selection use?

About 4.1k tokens (SKILL.md is roughly 16k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 2.4k tokens, read only when the agent opens those files.

What are the alternatives to Projection Selection?

Skills that share tags, products or a category with Projection Selection: Exploratory Data Analysis (spacering-net/codeg, 3.9k stars), Excel and CSV Data Analysis (bytedance/deer-flow, 84k stars), Exploratory Data Analysis (Oleafly/Oleafly, 212 stars) and Pandas Pro (Jeffallan/claude-skills, 12k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Projection Selection?

zzhonglei (a GitHub user) maintains it in zzhonglei/GeoCode-Release, which has 189 GitHub stars. The repository holds 7 skills in this directory. The repository was last updated on October 4, 2026.

Source: zzhonglei/GeoCode-Release on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.