CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

mapkit

Implement, review, or improve maps and location features in iOS/macOS apps using MapKit and CoreLocation. Use when working with Map views, annotations, markers, polylines, user location tracking, geocoding, reverse geocoding, search/autocomplete, directions and routes, geofencing, region monitoring, CLLocationUpdate async streams, or location authorization flows. Also use when working with maps, coordinates, addresses, places, directions, distance calculations, or location-based features in Swift apps.

Quality

94%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

The canonical home for this skill is dpearson2699/swift-ios-skills

SKILL.md
Quality
Evals
Security

Quality

Content

86%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

The body is a strong overview skill: fully executable code for all common MapKit/CoreLocation cases, clear multi-workflow structure, and exemplary progressive disclosure to two verified reference files. The only slack is minor token overhead (TOC and some checklist/reference duplication).

Suggestions

Remove the Contents TOC — the section headings are already short and scannable, and the ~10-line index duplicates them for no navigational gain in a file this size.

Tighten the overlap between Common Mistakes, the Review Checklist, and the reference files (e.g., CLMonitor's 20-condition limit and background-session rules live in mapkit-corelocation-patterns.md) by keeping only the review-facing checklist in SKILL.md and pointing to the reference for the rationale.

Add an inline denial-handling step to workflow 2 (track user location) so the sequence carries its own checkpoint, e.g., '5. On denied authorization, stop the task and present the Settings deep-link view from the Authorization Flow section.'

DimensionReasoningScore

Conciseness

The body is code-dense and assumes Claude's competence with almost no general-concept padding, but the ~10-line Contents TOC duplicates section headings and Common Mistakes/Review Checklist partially restate material also present in the reference files. Matches the 4 anchor (efficient, minor instances that could be trimmed); not 5 because a few tokens (TOC, checklist overlap) do not earn their place, and not 3 because the padding is minor.

4 / 5

Actionability

Every common case has executable, copy-paste-ready Swift: Map view with markers/controls, Annotation, MapPolyline/Polygon/Circle, MapCameraPosition variants, selection binding, CLLocationUpdate.liveUpdates() tracking task with accuracy filtering, CLServiceSession, authorization-denied Settings UI, CLGeocoder, MKGeocodingRequest, MKLocalSearchCompleter/ MKLocalSearch, MKDirections + route drawing, ETA, and PlaceDescriptor. Matches the 5 anchor; placeholder variables (routeCoords, applePark) are standard illustrative names and coverage of common cases is comprehensive.

5 / 5

Workflow Clarity

Five clearly sequenced numbered workflows cover the distinct task types, and the Review Checklist provides a validation pass for the review workflow. Matches the 4 anchor (clear sequence, most checkpoints present, minor gaps): individual build workflows lack inline verification steps (e.g., workflow 2 does not inline the denial-handling step it covers elsewhere). Not 5 because no explicit validate→fix→retry loop is embedded in the workflows, though none is strictly required since these are not destructive/batch operations.

4 / 5

Progressive Disclosure

Verified against the actual bundle: two well-named reference files one level deep, with every cited anchor (references/mapkit-patterns.md#complete-map-view-setup, #map-in-a-list-or-scrollview, #cycling-directions-ios-14) resolving to real headings. The intro's conditional pointers ('Read X when you need...') clearly signal when to load each file, and the References section annotates both files' scope. Matches the 5 anchor (clear overview, well-signaled one-level-deep references, easy navigation).

5 / 5

Total

18

/

20

Passed

Description

100%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

The description is exemplary: it states concrete actions, explicitly defines both what the skill does and when to use it with two trigger clauses, and covers natural synonyms comprehensively. It mirrors the strongest reference examples and has no notable weaknesses.

DimensionReasoningScore

Specificity

Concrete actions ('Implement, review, or improve') are followed by an exhaustive enumeration of specific capabilities: 'Map views, annotations, markers, polylines, user location tracking, geocoding, reverse geocoding, search/autocomplete, directions and routes, geofencing, region monitoring, CLLocationUpdate async streams, or location authorization flows'. This matches the 5 anchor (multiple specific concrete actions, comprehensive coverage); it is not 4 because there are no notable coverage gaps.

5 / 5

Completeness

Explicitly answers 'what' ('Implement, review, or improve maps and location features in iOS/macOS apps using MapKit and CoreLocation') and 'when' with two concrete 'Use when working with...' trigger clauses. This is the 5 anchor pattern verbatim; not 4 because the 'when' guidance is fully explicit rather than weakly implied.

5 / 5

Trigger Term Quality

Two trigger sentences cover natural keywords users would actually say — 'maps', 'annotations', 'markers', 'user location tracking', 'search/autocomplete', 'directions and routes', 'geofencing' — plus synonyms in the second clause ('coordinates, addresses, places, distance calculations, or location-based features in Swift apps'). Matches the 5 anchor's comprehensive synonym coverage; not 3 because common variations are all present.

5 / 5

Distinctiveness Conflict Risk

'MapKit and CoreLocation' scoped to 'iOS/macOS apps' is a clear niche with domain-specific triggers (CLMonitor-style terminology, geofencing, CLLocationUpdate). Matches the 5 anchor (clear niche, distinct triggers, minimal conflict risk); the only overlap is the intended Swift location-feature scope itself, so it is not 4.

5 / 5

Total

20

/

20

Passed

Validation

100%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

dpearson2699/swift-ios-skills

Path

skills/mapkit/SKILL.md

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.