CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

app-clips

Builds App Clips and their invocation, routing, App Store Connect experiences, size/capability limits, promotion, data handoff, notifications, and full-app migration. Use for App Clip Codes, URLs, NFC/QR, Safari/Maps/Messages invocation, NSUserActivity, or App Group/keychain transfer.

Quality

97%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

The canonical home for this skill is dpearson2699/swift-ios-skills

SKILL.md
Quality
Evals
Security

Quality

Content

92%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 overview skill: boundary-level guidance with exact entitlement keys, API names, and test mechanisms, explicit fix-and-retry validation checkpoints, and a clean three-file progressive-disclosure layout where every referenced file is real and one level deep. The only weakness is minor duplication of AASA/Smart App Banner details that the routing reference already owns.

DimensionReasoningScore

Conciseness

The body is lean and boundary-level, delegating implementation detail to references with no padding or explanation of concepts Claude already knows, but minor duplication remains: "use `app-id`, `app-clip-bundle-id`, and optional `app-clip-display=card`; do not rely on `app-argument`" and the `appclips:example.com` AASA guidance repeat content owned by references/routing-and-experiences.md (lines 87-110). This sits between the 'efficient' (4) and 'every token earns its place' (5) anchors — mostly earned, with a few trimmable inline details.

4 / 5

Actionability

Guidance is directly executable: exact menu path ("File → New → Target → App Clip"), bundle ID format, three raw entitlement key strings, `.onContinueUserActivity(NSUserActivityTypeBrowsingWeb)`, `scene(_:willConnectTo:options:)`, the `_XCAppClipURL` test variable, and `appclips:example.com` associated-domain format, with complete code examples in the referenced files. This is an instruction skill where absence of inline code is not penalized, and the specific guidance covers the common cases, matching the top anchor.

5 / 5

Workflow Clarity

Multi-step processes have explicit validation checkpoints with feedback loops — "Archive both targets and inspect their archived entitlements... correct the three raw key/target assignments above and rearchive until both pass" and "Exercise each URL with `_XCAppClipURL` and a Local Experience, fix routing/AASA/experience mismatches, and repeat" — plus a gated Review Checklist ("Do not ship until every applicable gate passes; fix failures and rerun the same gate"). This matches the anchor for clear sequencing with explicit validation, error-recovery loops, and a checklist.

5 / 5

Progressive Disclosure

The body is a clear overview with well-signaled, one-level-deep references: each of the three reference files exists, is appropriately scoped (~125-135 lines), and is loaded via explicit conditions ("Read [references/routing-and-experiences.md] when implementing..."), with a Contents nav and a References section listing all of them. No nesting beyond one level and no reference material that should be inlined.

5 / 5

Total

19

/

20

Passed

Description

100%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: third-person voice, comprehensive and specific capability list, and an explicit 'Use for' clause with natural trigger terms covering invocation methods, APIs, and handoff mechanisms. No vague fluff or over-claims.

DimensionReasoningScore

Specificity

The description lists multiple specific concrete action areas — "invocation, routing, App Store Connect experiences, size/capability limits, promotion, data handoff, notifications, and full-app migration" — giving comprehensive coverage of the App Clips domain, matching the top anchor. It is not score 4 because there are no meaningful gaps in coverage of what the skill does.

5 / 5

Completeness

It explicitly answers both questions: "Builds App Clips and their..." states what the skill does, and "Use for App Clip Codes, URLs, NFC/QR, Safari/Maps/Messages invocation, NSUserActivity, or App Group/keychain transfer" gives concrete when-to-use triggers. This matches the anchor for clearly and explicitly answering both what and when.

5 / 5

Trigger Term Quality

"Use for App Clip Codes, URLs, NFC/QR, Safari/Maps/Messages invocation, NSUserActivity, or App Group/keychain transfer" comprehensively covers the natural terms users would say for this domain, including invocation channels and API/technology synonyms. It is not score 4 because no commonly used trigger phrasing for App Clip work is obviously missing.

5 / 5

Distinctiveness Conflict Risk

"App Clips" is a clear niche with distinct triggers (App Clip Codes, NFC/QR, NSUserActivity, App Group handoff) that no general-purpose iOS skill would claim, so conflict risk is minimal. It is not score 4 because the triggers are specific enough that mis-triggering a sibling skill is unlikely.

5 / 5

Total

20

/

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/app-clips/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.