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 high-quality reference skill body: executable code throughout, explicit validation and retry loops in the one genuinely multi-step workflow (asset loading/import), a thorough review checklist, and a clean one-level split where the main file holds core maintenance patterns and a real, well-matched reference file holds advanced topics. The only room for improvement is trimming a handful of inline comments and one-line explanations that restate what Claude already knows.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is reference-dense and assumes competence: almost every section is a short code example or list with minimal prose, and hard-to-recall facts are stated tersely ("SceneKit renders a maximum of 8 lights per node", "Do not use SCNScene.Attribute.unit"). Minor over-explanation remains, e.g., inline comments like "// Ambient: uniform, no direction" and "Reusable, composable animation objects attached to nodes" restate things Claude knows, so it is efficient with a few trimmable spots rather than perfectly lean. | 4 / 5 |
Actionability | Nearly every section provides copy-paste-ready executable Swift covering the common cases: SCNView setup, scene loading with error handling, transforms, materials/PBR, all light types with parameters, camera configuration, all three animation approaches, physics bodies/forces/collision delegates, particle systems, and SwiftUI SceneView. The Common Mistakes section pairs DON'T/DO code, which is maximally actionable. | 5 / 5 |
Workflow Clarity | The asset-loading workflow has an explicit validation feedback loop: guard the resource URL, load with [.checkConsistency: true], verify required nodes, "stop on a consistency or required-node failure, fix the source asset or import options, then repeat the same check", and "require both export success and a checked reload before commit" for generated .scn files. A 19-item Review Checklist covers the remaining processes. This matches the anchor for clear sequence with explicit validation, error-recovery loops, and checklists. | 5 / 5 |
Progressive Disclosure | The body is a well-navigable overview with a contents list, and advanced topics (custom geometry, shader modifiers, constraints, morph targets, hit testing, scene serialization, render loop delegates, performance, SpriteKit overlay, LOD, Metal shaders) are externalized to one real one-level-deep reference (references/scenekit-patterns.md, verified to exist with a matching 'Scene Serialization' anchor for the body's anchor link). The References section enumerates exactly what the bundle file covers, so the split is appropriate and discovery is easy. | 5 / 5 |
Total | 19 / 20 Passed |