mapkit — Claude Code skill for Swift maps and location
Guides the agent through MapKit and CoreLocation code in Swift apps: maps, markers, geocoding, routes, geofencing.
npx skills add dpearson2699/swift-ios-skills --skill mapkit -a claude-codeWhat mapkit does
The skill covers Map and MapContentBuilder, markers, annotations, polylines and polygons. For live position it points to CLLocationUpdate.liveUpdates(), for geofences to CLMonitor. There are sections on geocoding, search with autocomplete, and directions.
Two reference files sit inside: references/mapkit-patterns.md for map setup, search, routes, Look Around and snapshots, and references/mapkit-corelocation-patterns.md for the update lifecycle, background location, testing and privacy keys. The agent reads them when a task goes past the basic example.
The target is iOS 17 and later, with some sections marked iOS 18 and iOS 26. Tracking position requires NSLocationWhenInUseUsageDescription in Info.plist, otherwise the system blocks access. Worth checking before running the examples on a device.
What it helps with
- add a map with markers to a SwiftUI screen
- stream location updates through an async sequence
- set up a geofence and react to region entry
- convert an address to coordinates and back
- calculate a route and draw it as a polyline
Example prompts for the agent
- Add a map to this screen with cafe markers and a user location button
- Track location with CLLocationUpdate.liveUpdates() and cancel the task when the view goes away
- Build place search with autocomplete and show results as markers
How to install mapkit
1Skills CLI (Vercel)
npx skills add dpearson2699/swift-ios-skills --skill mapkit -a claude-code2Manually: put the files in place
~/.claude/skills/mapkit/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/mapkit/
1Skills CLI (Vercel)
npx skills add dpearson2699/swift-ios-skills --skill mapkit -a codex2Manually: put the files in place
.agents/skills/mapkit/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add dpearson2699/swift-ios-skills --skill mapkit -a cursor2Manually: put the files in place
.cursor/skills/mapkit/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install dpearson2699/swift-ios-skills mapkit2Manually: put the files in place
.github/skills/mapkit/SKILL.md1Skills CLI (Vercel)
npx skills add dpearson2699/swift-ios-skills --skill mapkit -a gemini-cli2Platform CLI
gemini skills install https://github.com/dpearson2699/swift-ios-skills --path skills/mapkitManually: put the files in place
.devin/skills/mapkit/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add dpearson2699/swift-ios-skills --skill mapkit -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about mapkit
How do I install mapkit in Claude Code?
Run npx skills add dpearson2699/swift-ios-skills --skill mapkit -a claude-code. The skill file then lives at ~/.claude/skills/mapkit/SKILL.md.
What does the mapkit skill do?
It gives the agent MapKit and CoreLocation guidance: maps, markers, overlays, search, routes, geofencing and location authorization.
Which iOS version do the examples target?
iOS 17 and later, since the examples use SwiftUI Map and the async CoreLocation APIs. Some sections are marked iOS 18 and iOS 26.
