CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

mapkit

API reference: MapKit for SwiftUI. Map view, Marker, Annotation, camera positions, map features.

Quality

85%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

SKILL.md
Quality
Evals
Security

Quality

Content

100%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.

An exemplary reference-index skill: SKILL.md stays a lean navigation hub over one-level-deep topic files, with a concrete, fully specified fallback workflow for fetching pages not in the bundle. The referenced .md files sit at the skill root and were not present in the review copy, but the listing structure as presented is the ideal one-level progressive-disclosure pattern.

DimensionReasoningScore

Conciseness

The ~20-line body wastes nothing: a one-line scope statement ('MapKit for SwiftUI — maps, annotations, and location features (iOS 26+)'), a lean file table, and three terse fetch steps. Every token earns its place and nothing explains concepts Claude already knows, matching the 'lean and efficient' anchor.

5 / 5

Actionability

Guidance is concrete and executable: the table maps each topic to an exact file (e.g., 'marker.md | Marker (pin-style annotations)'), and step 3 gives a copy-paste-ready URL rule ('/documentation/mapkit/mkmapview' maps to 'https://sosumi.ai/documentation/mapkit/mkmapview') for the one non-obvious operation. As an instruction-only skill, the absence of code is not penalized.

5 / 5

Workflow Clarity

The doc-lookup fallback is an unambiguous if/else chain ('Search this skill's local .md files first' → 'If the topic is not here' → 'If no installed skill has the page'), with the source for documentation paths named ('mapkit-overview.md'). This is a simple single-purpose lookup skill with no destructive or batch operations, so the simple-skill exception applies and the single action is unambiguous.

5 / 5

Progressive Disclosure

The body is a pure index: seven flat, one-level-deep .md files, each with a one-line content description in a table ('mapkit-overview.md | Full MapKit framework index'), keeping SKILL.md as a lean overview with easy navigation — exactly the 'clear overview with well-signaled one-level-deep references' anchor.

5 / 5

Total

20

/

20

Passed

Description

66%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.

A lean, specific description that clearly states what the skill covers with strong domain keywords. Its main weakness is the absence of any 'Use when...' trigger clause, which caps completeness and leaves activation guidance entirely implicit.

Suggestions

Add an explicit trigger clause, e.g., 'Use when writing SwiftUI code with MapKit — Map views, markers, annotations, or camera positioning.'

Include natural synonyms users actually say ('map pins', 'user location', 'map coordinates') to broaden trigger-term coverage.

DimensionReasoningScore

Specificity

Names the domain ('API reference: MapKit for SwiftUI') and enumerates five concrete topics ('Map view, Marker, Annotation, camera positions, map features') — several specific items with minor gaps (e.g., user location, Look Around absent). It sits at anchor 4, not 5 (coverage is not comprehensive) and not 3 (more than 1-2 concrete items are listed).

4 / 5

Completeness

The 'what' is explicit ('API reference: MapKit for SwiftUI. Map view, Marker, Annotation, camera positions, map features.'), but there is no 'Use when...' clause or equivalent trigger guidance, which caps completeness at 3 per the judging guidelines. It is above 2 because 'what' is clear, and below 4 because 'when' is entirely absent rather than merely imprecise.

3 / 5

Trigger Term Quality

'MapKit', 'SwiftUI', 'Map', 'Marker', 'Annotation', and 'camera positions' are terms users naturally say when asking about SwiftUI maps. A few common synonyms ('pins', 'location', 'coordinates') are missing, matching anchor 4 ('good keyword coverage; a few natural terms missing') rather than the comprehensive synonym coverage of anchor 5.

4 / 5

Distinctiveness Conflict Risk

'MapKit for SwiftUI' carves a mostly distinct niche among Apple-framework reference skills, but terms like 'Annotation' and 'map features' carry minor overlap risk with closely related skills (e.g., a general SwiftUI or CoreLocation reference). This matches anchor 4 ('mostly distinct; minor overlap risk') rather than the clear-niche, minimal-conflict profile of anchor 5.

4 / 5

Total

15

/

20

Passed

Validation

87%

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

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

relative_links

Relative link issues: 7 missing

Warning

Total

14

/

16

Passed

Repository

Prisma-Labs-Dev/apple-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.