CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

avkit

Create media playback experiences using AVKit. Use when adding video players with AVPlayerViewController, enabling Picture-in-Picture, routing media with AirPlay, using SwiftUI VideoPlayer views, configuring transport controls, displaying subtitles and closed captions, or integrating AVFoundation playback with system UI.

Quality

91%

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

SKILL.md
Quality
Evals
Security

Quality

Content

85%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 entrypoint: lean, mistake-driven guidance with executable Swift examples, a clear sequenced workflow backed by a thorough verification checklist, and proper routing to two real one-level-deep reference files. The small deductions come from a version-specific line outside a deprecation section and inline examples that defer common setup cases entirely to the references.

Suggestions

Move the 'Targets Swift 6.4 / iOS 26+' version line into a dedicated compatibility or old-patterns note so version-sensitive details don't age the entrypoint.

Add one short inline snippet for the most common happy path (presenting an AVPlayerViewController or embedding VideoPlayer with a configured player) so the entrypoint is self-sufficient for basic setup before routing to references.

Consolidate the reference-file listings — avkit-patterns.md and core-implementation.md each appear in both 'Route by Task' and 'References' — into a single clearly labeled navigation section to remove duplication.

DimensionReasoningScore

Conciseness

The body is efficient and assumes competence — no padding explaining what AVKit or SwiftUI is, a tight 3-sentence intro, and lean code blocks. A version-specific line ('Targets Swift 6.4 / iOS 26+') sits outside any old-patterns/deprecated section, a minor instance that could be trimmed per the time-sensitivity guideline, keeping this just below anchor 5.

4 / 5

Actionability

Concrete, executable WRONG/CORRECT Swift for the four highest-risk mistakes (subclassing, audio session, PiP restore delegate, eager AVPlayer creation) and a checklist citing exact properties like 'canStartPictureInPictureAutomaticallyFromInline' and 'requiresLinearPlayback'. However, common cases such as basic playback setup, AirPlay routing, and subtitle selection have no inline code and are fully deferred to the reference files, so minor gaps keep it at anchor 4 rather than 5.

4 / 5

Workflow Clarity

The five-step workflow is clearly sequenced and ends with an explicit verification step ('Verify interruptions, route changes, foreground/background transitions, PiP restoration, captions, and teardown'), reinforced by a 17-item review checklist — matching anchor 5's explicit validation steps and checklists for complex processes. This is not a destructive or batch operation, so no cap applies.

5 / 5

Progressive Disclosure

The entrypoint is a genuine overview with a 'Route by Task' section clearly signaling two one-level-deep reference files (both verified to exist), and the split is deliberate ('focused implementation recipes moved out of the entrypoint'). Minor redundancy — the reference files are listed in both Route by Task and References — is not enough to drop below anchor 5's well-signaled, easy navigation.

5 / 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: concrete, comprehensive action coverage with an explicit and specific 'Use when' trigger clause naming the framework's key APIs. The only weakness is trigger-term coverage that omits a few natural synonyms such as 'PiP' and 'AVPlayer'.

DimensionReasoningScore

Specificity

The description lists multiple concrete actions spanning the framework's surface — 'adding video players with AVPlayerViewController', 'enabling Picture-in-Picture', 'routing media with AirPlay', 'configuring transport controls', 'displaying subtitles and closed captions' — which is comprehensive rather than having the minor gaps of anchor 4.

5 / 5

Completeness

Explicitly answers both parts: 'Create media playback experiences using AVKit' states what it does, and 'Use when adding video players with AVPlayerViewController, enabling Picture-in-Picture, routing media with AirPlay...' gives concrete enumerated trigger phrases for when to use it. Not anchor 4, where the 'when' clause could be more explicit.

5 / 5

Trigger Term Quality

Good natural-term coverage ('video players', 'Picture-in-Picture', 'AirPlay', 'subtitles', 'closed captions') but a few natural variations users say are missing, such as the 'PiP' abbreviation, 'AVPlayer' alone, or generic phrases like 'play video'. Fits anchor 4 better than anchor 5's comprehensive synonym coverage.

4 / 5

Distinctiveness Conflict Risk

Clear niche with framework-specific trigger names (AVKit, AVPlayerViewController, VideoPlayer) and minimal conflict risk; the phrase 'integrating AVFoundation playback with system UI' explicitly draws the boundary with a sibling AVFoundation skill rather than overlapping it.

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

thienqo/ios-skills

Path

skills/avkit/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.