Map Caption Writer
What This Skill Does
Writes a precise, context-rich caption for a published map that tells readers what geographic area is shown, what the map is measuring or illustrating, and why it matters to the story.
When To Use This Skill
- A map is ready for publication in print or digital and needs an accompanying caption
- A locator map, data map, or route map will appear alongside an article and the relationship between the visual and the story needs to be made explicit
- The map covers an area many readers may not recognise, requiring orientation
- A map shows change over time (e.g., territorial shifts, migration routes, flood extent) and the before/after needs to be explained in text
- A social media post will include a map image and needs a standalone caption that works without the full article
What You Need To Provide
Required:
- What geographic area the map covers (country, region, city, or specific zone)
- What the map is showing (locations of events, a data variable by area, a route, a boundary change, a risk zone, etc.)
- Why this is relevant to the story (one sentence of editorial context)
Optional:
- Key locations, labels, or markers on the map that you want the caption to reference
- Data source or cartographic source if the map uses a specific dataset
- Time period the map represents (especially important for historical or change-over-time maps)
- Preferred length (short: one sentence; standard: two sentences; extended: three to four sentences for complex geographic context)
How the Assistant Approaches This
- Opens by orienting the reader geographically — naming the area shown and anchoring it relative to a recognisable reference point if the location may be unfamiliar to the target audience
- States clearly what the map is measuring or illustrating and what the most significant geographic pattern or finding is (not a neutral description, but the editorial point the map makes)
- Adds source attribution and any essential note about time period, projection, or data boundary that a reader needs to interpret the map correctly
Output Format
One to three sentences plus an optional source line, totalling 25–70 words for standard captions. Lead sentence orients and names the phenomenon. Second sentence (if used) gives the editorial significance or describes the most important feature shown. Source line on a new line if a data source or map provider should be credited. No headline. Neutral, informative tone — no dramatic or promotional language. Specific place names over vague references.
Quality Criteria
Example
Input
Geographic area: The Salcedo River delta region in the fictional country of Maraverde, in the southern hemisphere
What the map shows: Areas of the delta that have been flooded in each of the past three rainy seasons, shown as overlapping shaded zones. Each season is a different colour. The map also marks the locations of six villages that fell within flood zones in at least two of the three seasons.
Editorial context: Part of an investigation into why disaster relief funding has not reached repeatedly affected communities
Data source: Regional Hydrological Authority, seasonal flood reports 2023–2025
Output
The Salcedo River delta, in southern Maraverde, has flooded in the same communities in each of the past three rainy seasons — a pattern that officials acknowledge but that has yet to trigger sustained relief funding. Six villages (marked) fell within designated flood zones in at least two of the three seasons shown, with the 2025 flood extent (darkest shading) reaching its largest recorded boundary.
Source: Regional Hydrological Authority, seasonal flood reports 2023–2025
Known Limitations
- This skill cannot read map image files — you must describe what the map shows; a vague description will produce a vague caption
- For maps covering areas likely to be unfamiliar to the publication's readership, you should specify a reference point ("in the northwest of the country, bordering X") in your input rather than leaving orientation entirely to the skill
- Does not advise on map design, projection choices, or colour accessibility — those are art direction decisions
- Highly technical maps (bathymetric, actuarial, satellite-composite) may need an additional methodology note that falls outside standard caption length; flag this and request an extended caption
Related Skills
1---2name: map-caption-writer3description: Writes a precise, context-rich caption for a published map that tells readers what geographic area is shown, what the map is measuring or illustrating, and why it matters to the story.4---5# Map Caption Writer67## What This Skill Does8Writes a precise, context-rich caption for a published map that tells readers what geographic area is shown, what the map is measuring or illustrating, and why it matters to the story.910## When To Use This Skill11- A map is ready for publication in print or digital and needs an accompanying caption12- A locator map, data map, or route map will appear alongside an article and the relationship between the visual and the story needs to be made explicit13- The map covers an area many readers may not recognise, requiring orientation14- A map shows change over time (e.g., territorial shifts, migration routes, flood extent) and the before/after needs to be explained in text15- A social media post will include a map image and needs a standalone caption that works without the full article1617## What You Need To Provide18**Required:**19- What geographic area the map covers (country, region, city, or specific zone)20- What the map is showing (locations of events, a data variable by area, a route, a boundary change, a risk zone, etc.)21- Why this is relevant to the story (one sentence of editorial context)2223**Optional:**24- Key locations, labels, or markers on the map that you want the caption to reference25- Data source or cartographic source if the map uses a specific dataset26- Time period the map represents (especially important for historical or change-over-time maps)27- Preferred length (short: one sentence; standard: two sentences; extended: three to four sentences for complex geographic context)2829## How the Assistant Approaches This301. Opens by orienting the reader geographically — naming the area shown and anchoring it relative to a recognisable reference point if the location may be unfamiliar to the target audience312. States clearly what the map is measuring or illustrating and what the most significant geographic pattern or finding is (not a neutral description, but the editorial point the map makes)323. Adds source attribution and any essential note about time period, projection, or data boundary that a reader needs to interpret the map correctly3334## Output Format35One to three sentences plus an optional source line, totalling 25–70 words for standard captions. Lead sentence orients and names the phenomenon. Second sentence (if used) gives the editorial significance or describes the most important feature shown. Source line on a new line if a data source or map provider should be credited. No headline. Neutral, informative tone — no dramatic or promotional language. Specific place names over vague references.3637## Quality Criteria38- [ ] The geographic area is named and, where needed, anchored with a recognisable reference point39- [ ] The caption states what the map shows, not just what type of map it is ("a shaded relief map of...")40- [ ] The most important geographic finding or pattern is named explicitly41- [ ] Time period is specified if the map represents a specific moment or range42- [ ] The caption can stand alone — a reader who cannot see the map still understands the editorial point43- [ ] No redundancy with labels or titles already visible on the map face4445## Example4647### Input48Geographic area: The Salcedo River delta region in the fictional country of Maraverde, in the southern hemisphere49What the map shows: Areas of the delta that have been flooded in each of the past three rainy seasons, shown as overlapping shaded zones. Each season is a different colour. The map also marks the locations of six villages that fell within flood zones in at least two of the three seasons.50Editorial context: Part of an investigation into why disaster relief funding has not reached repeatedly affected communities51Data source: Regional Hydrological Authority, seasonal flood reports 2023–20255253### Output54The Salcedo River delta, in southern Maraverde, has flooded in the same communities in each of the past three rainy seasons — a pattern that officials acknowledge but that has yet to trigger sustained relief funding. Six villages (marked) fell within designated flood zones in at least two of the three seasons shown, with the 2025 flood extent (darkest shading) reaching its largest recorded boundary.5556Source: Regional Hydrological Authority, seasonal flood reports 2023–20255758## Known Limitations59- This skill cannot read map image files — you must describe what the map shows; a vague description will produce a vague caption60- For maps covering areas likely to be unfamiliar to the publication's readership, you should specify a reference point ("in the northwest of the country, bordering X") in your input rather than leaving orientation entirely to the skill61- Does not advise on map design, projection choices, or colour accessibility — those are art direction decisions62- Highly technical maps (bathymetric, actuarial, satellite-composite) may need an additional methodology note that falls outside standard caption length; flag this and request an extended caption6364## Related Skills65- [infographic-caption-writer](../infographic-caption-writer/SKILL.md)66- [location-brief-writer](../../../tv-documentary/pre-production/location-scout-brief/SKILL.md)67- [sidebar-fact-box-writer](../../../magazine-journalism/writing/sidebar-fact-box-writer/SKILL.md)