Content
78%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 strong, code-first skill body with excellent progressive disclosure and a genuinely useful raycasting-distinctions section, held back slightly by repeated capability-check guidance, some boilerplate SwiftUI, and an underspecified ARKit raycast example. The Review Checklist and DON'T sections make it reliably actionable.
Suggestions
Show the ARRaycastQuery construction and how to obtain the ARSession (e.g., via RealityView's ARSession accessor or UIViewRepresentable) in the Raycasting example so the snippet is fully executable end-to-end.
Consolidate the `ARWorldTrackingConfiguration.isSupported` guidance into the Setup section and reference it from elsewhere instead of restating it in RealityView Basics, Scene Understanding, and Common Mistakes.
Compress the camera-permission example to the essential authorization-status/request pattern and its fallback UI, and add a short failure-recovery note (e.g., what to do when a plane anchor fails to resolve or a USDZ load throws) to strengthen workflow checkpoints.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly efficient, domain-specific code with little padding, but there are minor trims: the `ARWorldTrackingConfiguration.isSupported` guidance is repeated across Setup, RealityView Basics, Scene Understanding, and Common Mistakes, and the ~35-line camera-permission example is largely boilerplate SwiftUI Claude already knows. Not level 5 ('every token earns its place') given this duplication; not level 3 since none of it is generic concept explanation. | 4 / 5 |
Actionability | Nearly all guidance is executable, copy-paste Swift (RealityView setup, make/update, anchoring, drag gesture, permission gating, wrong-vs-correct pairs). The gap keeping it below level 5 is the ARKit raycast path: `let results = session.raycast(query)` never shows how the `ARRaycastQuery` is constructed or how the session is obtained within a SwiftUI/RealityView context. | 4 / 5 |
Workflow Clarity | The skill is reference-style rather than a multi-step process, and it is clearly sequenced (Setup → RealityView → entities → anchoring → raycasting → gestures → mistakes → Review Checklist) with a checklist serving as verification checkpoints. It falls short of level 5 because there are no explicit validate-and-recover feedback loops (e.g., what to do when a plane anchor never resolves or a model fails to load), and no destructive/batch operation that would trigger a cap. | 4 / 5 |
Progressive Disclosure | The body is a concise overview that correctly defers physics, animations, lighting, ECS, occlusion, accessibility, and performance to a single real, one-level-deep reference (references/realitykit-patterns.md, whose 'Entity Animations' anchor the body links to), signposted both inline and in a References section. This matches the level-5 anchor exactly. | 5 / 5 |
Total | 17 / 20 Passed |