CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

avfoundation-audio

Configure AVAudioSession categories, modes, route changes, interruptions, and build low-latency AVAudioEngine node graphs for recording, mixing, and audio processing in iOS and iPadOS apps.

Quality

84%

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

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, code-first skill body: executable examples covering the core AVFoundation audio cases, a useful mistakes section and review checklist, and a well-structured one-level reference split. Minor room for improvement exists in trimming concept re-explanations and adding error-recovery guidance, but overall it is highly actionable and well organized.

DimensionReasoningScore

Conciseness

The body is dominated by executable Swift with brief, useful framing, but contains minor over-explanation of concepts Claude already knows (e.g., 'AVAudioSession coordinates app audio with the system audio subsystem' and 'AVAudioEngine coordinates a graph of AVAudioNode instances'). This matches the 4 anchor — efficient with a few trimmable sentences — rather than the 5 anchor where every token earns its place.

4 / 5

Actionability

Four complete, executable Swift code blocks cover the common cases (session configuration, async interruption handling, playback graph, microphone tap), reinforced by concrete directives like 'Always call removeTap(onBus:) first' and pausing on '.oldDeviceUnavailable'. Code is copy-paste ready with real class implementations, matching the 5 anchor.

5 / 5

Workflow Clarity

Sections are clearly sequenced (session configuration → notifications → engine graph → taps) and the Review Checklist provides verification checkpoints, but there are no explicit error-recovery feedback loops. This fits the 4 anchor ('clear sequence with most checkpoints present; minor validation gaps') rather than 5, which requires explicit feedback loops; it is above 3 because checkpoints are present rather than missing.

4 / 5

Progressive Disclosure

The SKILL.md is a lean overview with a Contents TOC, and advanced material (multi-track mixer graphs, real-time effects, format conversion, permission/recording) is appropriately split into references/audio-engine-patterns.md — a real file that is well-signaled in the References section with a descriptive annotation and is one level deep with no nested references.

5 / 5

Total

18

/

20

Passed

Description

75%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 specific, well-scoped description with strong concrete action verbs and distinctive API-name triggers. Its main weakness is the absence of any explicit 'Use when...' trigger guidance, which caps completeness and leaves a few natural trigger terms unexplored.

Suggestions

Add an explicit trigger clause, e.g., 'Use when working with iOS audio: microphone recording, playback, audio sessions, route changes, interruptions, or AVAudioEngine/AVAudioSession APIs.'

Include commonly used natural terms such as 'microphone', 'playback', and 'audio session' so users phrasing requests around those words will match the skill.

DimensionReasoningScore

Specificity

The description enumerates multiple concrete, API-level actions — 'Configure AVAudioSession categories, modes, route changes, interruptions' and 'build low-latency AVAudioEngine node graphs for recording, mixing, and audio processing' — giving comprehensive coverage of both session and engine concerns. It exceeds the 4 anchor because the action list is broad and specific rather than having notable gaps.

5 / 5

Completeness

The 'what' is clearly and concretely stated, but there is no 'Use when...' clause or equivalent explicit trigger guidance; 'in iOS and iPadOS apps' only weakly implies when to use it. Per the judging guidelines, a missing trigger clause caps completeness at 3, and the description is not at 4 because the 'when' is absent rather than merely imprecise.

3 / 5

Trigger Term Quality

Includes natural terms users would say such as 'AVAudioSession', 'AVAudioEngine', 'recording', 'mixing', 'route changes', 'interruptions', and 'iOS'. A few common natural terms are missing (e.g., 'microphone', 'playback', 'audio session'), which matches the 4 anchor rather than the comprehensive 5 anchor.

4 / 5

Distinctiveness Conflict Risk

The description occupies a clear niche — AVFoundation audio on iOS/iPadOS — with distinct framework-specific triggers (AVAudioSession, AVAudioEngine) that are unlikely to fire for unrelated skills. It matches the 5 anchor for minimal conflict risk.

5 / 5

Total

17

/

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/avfoundation-audio/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.