CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

healthkit

Read, write, and query Apple Health data using HealthKit. Covers HKHealthStore authorization, sample queries, statistics queries, statistics collection queries for charts, saving HKQuantitySample data, background delivery, workout sessions with HKWorkoutSession and HKLiveWorkoutBuilder, HKUnit, and HKQuantityTypeIdentifier values. Use when integrating with Apple Health, displaying health metrics, recording workouts, or enabling background health data delivery.

Quality

92%

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

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

High-quality content: fully executable async-descriptor Swift for every core operation, explicit save/workout validation gates with error-recovery guidance, and a genuine review checklist. The main file is somewhat long for an overview, with inline lookup tables that could move to the existing reference file.

DimensionReasoningScore

Conciseness

The body is largely efficient — executable Swift with terse, non-obvious notes (e.g., "Treat `try await healthStore.save(sample)` returning as the save success gate"). However, the 12-row HKQuantityTypeIdentifier table and the inline "HKUnit Reference" block are lookup material that could be offloaded to the reference file, keeping it short of the every-token-earns-its-place 5 anchor.

4 / 5

Actionability

Every section gives copy-paste-ready, complete Swift (fetchRecentHeartRates, fetchTodayStepCount, fetchDailySteps, saveSteps, enableStepCountBackgroundDelivery, startWorkout) covering the common cases, exactly matching the fully-executable top anchor.

5 / 5

Workflow Clarity

Multi-step flows are clearly sequenced with explicit validation checkpoints and feedback loops: the save success gate with error correction ("surface the error and correct the known authorization, type, unit, duration, or input problem before constructing another sample"), the workout teardown order ("Wait for the session delegate's `.stopped` transition, then await `builder.endCollection(at:)` followed by `builder.finishWorkout()`"), and a 15-item Review Checklist.

5 / 5

Progressive Disclosure

Good structure with a TOC and a clearly signaled, one-level-deep reference ("see [references/healthkit-patterns.md](references/healthkit-patterns.md)" — verified to exist and match the promised scope). The main file runs ~440 lines with data-type and unit tables inline that arguably belong in the reference bundle, a minor organization gap versus the cleanly split 5 anchor.

4 / 5

Total

18

/

20

Passed

Description

92%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: comprehensive, specific action list in third person with an explicit "Use when..." trigger clause naming natural user scenarios. The only gap is a handful of missing natural synonyms (heart rate, steps, fitness data) that keeps trigger coverage just short of exhaustive.

DimensionReasoningScore

Specificity

The description lists multiple concrete actions — "Read, write, and query Apple Health data", "HKHealthStore authorization", "sample queries, statistics queries, statistics collection queries for charts, saving HKQuantitySample data, background delivery, workout sessions" — giving comprehensive coverage of the domain's capabilities rather than the minor gaps of the 4 anchor.

5 / 5

Completeness

It explicitly answers both what ("Read, write, and query Apple Health data using HealthKit. Covers HKHealthStore authorization, sample queries...") and when ("Use when integrating with Apple Health, displaying health metrics, recording workouts, or enabling background health data delivery") with concrete trigger phrases, matching the top anchor exactly.

5 / 5

Trigger Term Quality

Good natural-term coverage: "integrating with Apple Health", "displaying health metrics", "recording workouts", "enabling background health data delivery" are phrases users would say. A few common variations are missing (e.g., "heart rate", "steps", "fitness data"), so it stops short of the comprehensive-synonym 5 anchor.

4 / 5

Distinctiveness Conflict Risk

A clear niche — Apple Health / HealthKit on Apple platforms — with named framework types (HKHealthStore, HKWorkoutSession, HKLiveWorkoutBuilder) as distinct triggers; minimal risk of firing for an unrelated skill.

5 / 5

Total

19

/

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