CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

relevancekit

Increase widget visibility on Apple Watch using RelevanceKit. Use when providing contextual relevance signals for watchOS widgets, declaring time-based or location-based relevance, combining multiple relevance providers, helping the system surface the right widget at the right time on watchOS 26, or routing mixed RelevanceKit/WidgetKit/HealthKit/MapKit Smart Stack scope.

Quality

89%

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 well-structured, highly actionable reference with executable Swift examples and a clean one-level-deep bundle split. Its only notable weakness is mild redundancy between the body's factory/grouping examples and the references file, plus a topic-oriented rather than explicitly sequenced workflow.

DimensionReasoningScore

Conciseness

The body is efficient and code-first, assuming competence (tables for types/permissions, terse factory snippets, a beta caveat instead of hedging prose), but includes some trimmable material: the three location rows in the Permissions table repeat identical text, and the time/location factory variants and grouping examples duplicate content in references/relevancekit-patterns.md. This matches anchor 4 ("efficient; minor instances… that could be trimmed") better than anchor 5's every-token-earns-its-place.

4 / 5

Actionability

Code is fully executable Swift with imports, availability annotations, complete provider implementations, and optionality handling (location(category:) nil check, isAuthorizedForWidgetUpdates, .associatedKind, grouping variants), with common cases covered and full entry/placeholder implementations deferred to a real references file. This matches anchor 5.

5 / 5

Workflow Clarity

There is a clear implicit sequence (Setup → provider choice with explicit decision rules → integration → mistakes → checklist) and validation checkpoints exist (Review Checklist, permission granted/denied testing, Developer Mode), but the body is topic-organized rather than an explicit step sequence, so checkpoints are distributed rather than inline. This sits between anchor 4 and 5, landing at 4.

4 / 5

Progressive Disclosure

Verified against the actual bundle: one references file (references/relevancekit-patterns.md) exists, is one level deep, and contains the sections the body links to via anchors (#preview-recipes, #testing-tips) plus full provider implementations and permission handling. The SKILL.md body is a clear overview with a Contents TOC and well-signaled split — matches anchor 5.

5 / 5

Total

18

/

20

Passed

Description

88%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 strong description with explicit what-and-when structure, concrete actions, and domain-natural trigger terms. Its main weaknesses are the missing natural trigger terms for fitness/sleep/hardware relevance use cases and a routing trigger that slightly overlaps sibling skill territory.

DimensionReasoningScore

Specificity

The description lists multiple specific concrete actions — "Increase widget visibility on Apple Watch using RelevanceKit", "providing contextual relevance signals", "declaring time-based or location-based relevance", "combining multiple relevance providers", and "routing mixed RelevanceKit/WidgetKit/HealthKit/MapKit Smart Stack scope" — comprehensively covering what the skill does. It exceeds the anchor-4 example, which had minor coverage gaps.

5 / 5

Completeness

It clearly answers both: the "what" is "Increase widget visibility on Apple Watch using RelevanceKit" via contextual relevance signals, and an explicit "Use when…" clause lists concrete trigger phrases (declaring time/location relevance, combining providers, surfacing widgets on watchOS 26, routing mixed-framework scope). This matches the anchor-5 example structure exactly.

5 / 5

Trigger Term Quality

Good natural keyword coverage ("widget visibility", "Apple Watch", "Smart Stack", "watchOS widgets", "RelevanceKit") that users would naturally say, but a few natural terms for major use cases documented in the body are missing — no fitness/workout, sleep, or connected-hardware trigger words. This matches anchor 4 ("good keyword coverage; a few natural terms missing") rather than anchor 5's comprehensive synonyms.

4 / 5

Distinctiveness Conflict Risk

The RelevanceKit/watchOS Smart Stack niche is clear and mostly distinct, but the trigger "routing mixed RelevanceKit/WidgetKit/HealthKit/MapKit Smart Stack scope" deliberately claims overlap territory with sibling WidgetKit/HealthKit/MapKit skills, creating minor conflict risk with closely related skills. Not anchor 5's "minimal conflict risk", but well above anchor 3's generic overlap.

4 / 5

Total

18

/

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