CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

shazamkit

Recognize music and audio with ShazamKit using SHManagedSession, SHSession, SHCustomCatalog, and SHSignatureGenerator for live microphone matching and custom audio catalogs in iOS apps.

Quality

81%

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

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

The body is a lean, highly actionable reference: complete executable Swift examples for each of the four main ShazamKit approaches, explicit pitfalls, and a review checklist. Structure and disclosure are solid with one verified, clearly-signaled reference file for advanced patterns. Remaining gains are minor: add an explicit error-recovery/validation loop and consider moving one or two full examples into the reference file.

DimensionReasoningScore

Conciseness

Each section is a one-line orientation sentence followed directly by executable code, assuming Claude's competence with no explanation of basic concepts. Minor trims are possible: the Contents TOC duplicates section headers, and the time-sensitive "iOS 17+" version mention is not placed in a deprecated/old-patterns section, so it falls just short of anchor 5.

4 / 5

Actionability

Four complete, copy-paste-ready Swift examples (SHManagedSession, SHSession with AVAudioEngine tap, SHCustomCatalog, SHSignatureGenerator) cover the common cases, with a Common Mistakes section flagging real pitfalls (force-unwrapped buffer aside). Matches anchor 5's "fully executable; copy-paste ready; covers the common cases".

5 / 5

Workflow Clarity

Per-task sequences are clear within the code (start/stop pairing, tap install/removal) and selection criteria are stated ("On iOS 17+", "When manual control over the AVAudioEngine pipeline... is required"), with a Review Checklist as checkpoints. It lacks an explicit validate-fix-retry loop, so it sits at anchor 4 rather than 5.

4 / 5

Progressive Disclosure

Good structure: organized sections with headers, a clearly signaled one-level-deep reference (references/shazamkit-patterns.md, verified to exist with no nested references) described as covering advanced patterns, and easy navigation. It falls short of anchor 5 because all four full code examples live inline in SKILL.md with only one advanced file split out — a few could be pushed to references to keep the overview leaner.

4 / 5

Total

17

/

20

Passed

Description

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

The description is specific and highly distinctive, naming concrete ShazamKit APIs and actions in a clear niche. Its main weakness is the absence of any "Use when..." trigger guidance, which caps completeness and leaves activation cues implicit. Adding natural synonyms (e.g., "identify songs", "sound recognition") would strengthen trigger term coverage.

Suggestions

Add an explicit trigger clause, e.g., "Use when the user wants to identify songs or audio in an iOS app, mentions Shazam/ShazamKit, or needs to build custom audio matching catalogs."

Include natural synonyms users would say — "identify song", "what song is this", "sound/music recognition" — alongside the API class names.

Trim or relocate the raw list of four class names to the body, keeping the description focused on user-facing actions (recognize music, match live microphone audio, build custom catalogs).

DimensionReasoningScore

Specificity

Lists several concrete actions ("Recognize music and audio", "live microphone matching", "custom audio catalogs") plus named APIs (SHManagedSession, SHSession, SHCustomCatalog, SHSignatureGenerator), with minor coverage gaps such as offline/batch signature matching. It exceeds anchor 3 (only 1-2 concrete actions) but falls short of anchor 5's comprehensiveness.

4 / 5

Completeness

The "what" is clearly stated (recognize music/audio with ShazamKit via the named classes), but there is no "Use when..." clause or equivalent explicit trigger guidance, which caps completeness at 3 per the judging guidelines. Not anchor 2 because the "what" is concrete and specific, not vague.

3 / 5

Trigger Term Quality

Natural terms users would say are present ("recognize music", "audio", "microphone", "iOS apps"), giving good keyword coverage, but common synonyms like "identify song", "what song is this", or "sound recognition" are missing. Better than anchor 3's partial coverage, short of anchor 5's synonym/extension comprehensiveness.

4 / 5

Distinctiveness Conflict Risk

Clear niche (ShazamKit audio recognition in iOS) with distinct triggers including specific class names, making conflict with other skills minimal. Matches anchor 5's "clear niche with distinct triggers; minimal conflict risk".

5 / 5

Total

16

/

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