Content
92%Weight 40%Scale 1-5Reviews 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.
| Dimension | Reasoning | Score |
|---|---|---|
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 |