CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

weatherkit

Fetch WeatherKit current, minute, hourly, and daily forecasts; weather alerts; iOS 18+ changes, historical comparisons, summaries, and statistics; and required Apple Weather attribution. Use when integrating weather data, showing forecasts or alerts, caching WeatherKit responses, displaying attribution, or reviewing WeatherKit query limits in iOS 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.

A strong API-usage skill body: fully executable Swift examples, disciplined selective-query guidance, corrective Common Mistakes, and a review checklist, with extended patterns correctly deferred to a real, well-linked reference file. Its main costs are minor redundancy (TOC, repeated iteration snippets) and the absence of an explicit multi-step workflow with feedback loops, though that largely reflects the nature of an API skill.

Suggestions

Trim redundancy for conciseness: drop or shorten the Contents anchor list and the opening paragraph that repeats the frontmatter description, and collapse the standalone iteration snippets (e.g., 'for hour in hourlyForecast') into the fetch functions they follow.

Strengthen workflow clarity with a short ordered "typical integration flow" (request location permission → check availability for minute/alerts → selective fetch → display with formatted measurements → cache until metadata.expirationDate → show attribution) that ties the existing sections into one sequence with the review checklist as its validation step.

DimensionReasoningScore

Conciseness

The body is efficient — terse prose, tight code blocks, reference tables instead of prose — but has minor trim opportunities: the 11-line Contents TOC duplicates markdown anchors, the opening paragraph repeats the frontmatter description, and iteration snippets like "for hour in hourlyForecast" restate patterns already shown. Not 5: these small redundancies mean not every token earns its place; not 3: there is no over-explanation of concepts Claude already knows.

4 / 5

Actionability

Every operation has complete, copy-paste-ready Swift: fetch functions with signatures and return types, selective-query examples with tuple destructuring, the query-type table mapping each WeatherQuery to its return type, and the attribution properties table. Not 4: the examples cover the common cases (current, hourly, daily, custom range, alerts, minute, availability) with executable code throughout.

5 / 5

Workflow Clarity

Setup is a numbered 4-step sequence, "Common Mistakes" gives corrective counter-examples (wrong vs. correct entitlement code), and the 13-item Review Checklist serves as an explicit validation checkpoint. Not 5: this is a task-based API reference rather than a sequenced workflow with feedback loops (e.g., fetch → handle nil/unavailable → retry), so checkpoints exist but no validate-fix-retry loop; not 3: setup sequence and checklist provide clear validation.

4 / 5

Progressive Disclosure

The body keeps core API usage inline and pushes extended material to the verified references/weatherkit-patterns.md (SwiftUI dashboard, charts, caching actor, historical statistics), with well-signaled one-level-deep links including an anchor ("#caching-strategy") and descriptive reasons for loading each. Not 4: navigation via the Contents list plus purposeful, clearly-signaled references leaves no organization gaps.

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.

An exemplary description: concrete, comprehensive, third-person, with an explicit and natural 'Use when...' trigger clause that spans integration, display, caching, and compliance scenarios. Minimal conflict risk given the framework-specific niche.

DimensionReasoningScore

Specificity

The description lists multiple concrete actions — "Fetch WeatherKit current, minute, hourly, and daily forecasts; weather alerts; iOS 18+ changes, historical comparisons, summaries, and statistics; and required Apple Weather attribution" — comprehensively covering the framework's capabilities in third-person voice. Not 4: there are no meaningful coverage gaps; every WeatherKit dataset type and the attribution requirement are named.

5 / 5

Completeness

Both questions are answered explicitly: the first sentence concretely states what the skill does, and "Use when integrating weather data, showing forecasts or alerts..." gives explicit trigger guidance with concrete phrases. Not 4: the 'when' clause is not merely present but specific and multi-faceted.

5 / 5

Trigger Term Quality

Natural user phrasings are comprehensively covered: "integrating weather data", "showing forecasts or alerts", "caching WeatherKit responses", "displaying attribution", "reviewing WeatherKit query limits in iOS apps", alongside the framework name itself. Not 4: the trigger terms span feature-level, API-level, and compliance-level requests a user would actually say.

5 / 5

Distinctiveness Conflict Risk

The description occupies a clear niche — Apple WeatherKit in iOS apps — with distinct triggers (attribution, query limits, minute forecasts) unlikely to fire for unrelated skills. Not 4: even closely related skills (e.g., generic CoreLocation or networking skills) would not reasonably collide with these triggers.

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/weatherkit/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.