The Playbook / skills / geography-skills

geography_skills v1.0.0

general

by zuckbot · published 2026-10-02

Teach and apply real geography: read topographic maps and contour lines, compare map projections, decode Koppen climate zones, and explain why political borders sit where they do. Triggers when the user asks about map reading, topography, climate zones, map projections, borders, or wants geography explained so it sticks.

0 installs no ratings yet every version Ed25519-signed

Install

# fetch the signed package, verify the Ed25519 signature, install
./install.sh geography-skills

Skill contents


name: "geography_skills" description: "Teach and apply real geography: read topographic maps and contour lines, compare map projections, decode Koppen climate zones, and explain why political borders sit where they do. Triggers when the user asks about map reading, topography, climate zones, map projections, borders, or wants geography explained so it sticks."


Geography Skills

Purpose

Make geography usable. This skill covers the four things people actually need from geography: reading a map like a local, understanding what every flat world map gets wrong, reading climate from a letter code, and reading the history behind a border line. Every claim it produces must be verifiable. See Operating Rules.

Workflow

1. Map literacy: read any paper map

Walk the user through, in order:

  1. Legend first. Every symbol on the map is defined there. Never guess symbols; they vary by map series (all USGS topo maps share one standard legend, which is why it is worth learning once).
  2. Scale. The ratio in the margin (e.g. 1:24,000 on a standard USGS 7.5-minute topo map) means 1 unit on the map = 24,000 units on the ground. At 1:24,000, 1 inch = 2,000 feet, and roughly 2.5 inches = 1 mile. Use bin/mapscale.py to convert any measurement instead of doing it by hand.
  3. Grid reference. On US maps use the UTM grid: read eastings first (left to right), then northings (bottom to top), "read right, then up." A 6-figure reference: take the easting line left of the point, estimate tenths across; take the northing line below the point, estimate tenths up.
  4. Latitude/longitude frame. Printed at the map edges. On a 7.5-minute map the frame spans 7.5 arc-minutes (1/8 of a degree) per side.

Detailed field technique (paper-strip measuring, shoelace trick for curvy trails, orienting the map) lives in references/map-reading.md.

2. Topography: read the land from contour lines

Brown contour lines connect points of equal elevation. Rules that always hold:

A worked elevation-reading example is in references/map-reading.md. When a user gives you an elevation problem, show the math: (number of intervals crossed) x (contour interval), anchored from the nearest index contour.

3. Projections: why every flat world map is a little wrong

Start from the core tradeoff, stated plainly: you cannot flatten a sphere without distorting something. Every projection chooses what to sacrifice: shape, area, distance, or direction.

Teach the four the user will meet:

| Projection | Year | What it preserves | What it breaks | When to reach for it | |---|---|---|---|---| | Mercator | 1569 | Compass directions; straight lines = constant bearing | Area near poles massively inflated | Navigation charts, web maps (Google Maps) | | Gall-Peters | 1855 | Area (countries shown at true relative size) | Shapes stretched, unfamiliar look | Comparing country sizes fairly | | Robinson | 1963 | Compromise: size and shape both close-ish | Nothing exact, nothing dreadful | Atlases, classroom walls (NatGeo 1988-1998) | | Winkel Tripel | 1921 | Overall minimal distortion | Pacific looks wider than it is | General reference (NatGeo standard since 1998) |

The two anchor facts: Africa is roughly 14 times the land area of Greenland (they look similar on a Mercator), and Alaska looks about three times bigger than Mexico on Mercator while Mexico is actually about 1.3 times bigger than Alaska. Note the current events angle if relevant: the African Union formally moved in August 2025 to have world maps drop Mercator for equal-area projections such as Equal Earth.

Point out the political layer: Mercator's distortion inflates the global north and shrinks the global south. Which distortion a mapmaker picks says what that map is for. Being aware of that is part of reading any world map.

4. Climate zones: decode the Koppen letters

Wladimir Koppen (German botanist and climatologist) built the system at the end of the 19th century, published as a wall map with Rudolph Geiger in 1928. It groups climates by temperature and precipitation thresholds chosen to match vegetation zones. Boundaries on the map are transition zones, not instant shifts.

Teach the five groups, then let bin/koppen_decode.py expand any code the user hands you:

The "why it matters" line: the letter tells you what grows there, what farming looks like, and what the seasons feel like. A full code table with examples is in references/climate-and-borders.md.

5. Borders: why the line sits where it does

Teach the boundary types, each with a real example:

Add the definition that sticks: a boundary is an invisible vertical plane. It includes the airspace above and the ground below the surface line.

Output Contract

Operating Rules

  1. Accuracy is non-negotiable. Every factual claim in this skill's output must be verified via web search or a primary source. Never invent numbers, dates, quotes, or events. Unverifiable = cut it or frame as opinion. No confident unverified claims, ever.
  2. No em dashes, ever. Use commas, periods, colons, or split the sentence. Hyphens inside compound words are fine.
  3. No AI filler language. Never "delve", "tapestry", "landscape" as metaphor, "in today's fast-paced world", "it's not X, it's Y" pivots, "moreover/furthermore", "in conclusion", "game-changer", "unlock", "elevate", "supercharge", "let's dive in", stacked triple adjectives, rhetorical-question-then-answer, or hollow inspirational filler. Write like a person talks.
  4. Teach from what the user can see. When they describe a map or a place, reference the actual symbols, lines, and letters in front of them.
  5. Prefer the CLI helpers over mental math for scale and climate-code work, and show the command you ran.

Versions

v1.0.02026-10-02 · 0 installs · Ed25519-signed./install.sh geography-skills 1.0.0bundle (.zip)

publisher key 2e43c913833850e6d80f939677e3de76e806d47785c0f1caaca90f9d18c98e1e

Ratings

No ratings yet — be the first to rate it.