Content
82%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 progressive-disclosure routing skill that is lean and actionable, with concrete global rules and a clear three-step workflow. Main gaps are the absence of any inline code sample and the referenced recipe folders not being present in the supplied bundle.
Suggestions
Include one short inline SwiftUI code snippet (e.g., a scoped withAnimation spring) so the body demonstrates the expected recipe style without requiring a file load.
Ship the referenced recipe folders (on-scroll/, on-tap/, on-appear/, on-drag/, on-state-change/, on-focus/) with at least their README.md indexes so referenced paths resolve in the bundle.
Add an explicit verify step for non-scroll recipes (e.g., 'confirm the animation respects Reduce Motion') to generalize the existing scroll-perf checkpoint into a full validation loop.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Lean body with a routing table, terse numbered steps, and eight high-signal global rules; assumes Claude's SwiftUI competence and avoids explaining basics, with every section earning its place. | 5 / 5 |
Actionability | Provides a concrete routing procedure, explicit tie-break rule ('on scroll beats morph'), and specific API names (.spring(response:dampingFraction:), GlassEffectContainer, accessibilityReduceMotion), but contains no inline runnable SwiftUI code sample since recipes live in unloaded files. | 4 / 5 |
Workflow Clarity | Three clearly sequenced steps (identify trigger, read folder README, read only matched recipe) with an explicit fallback path and a shipping checkpoint (performance.md Scroll-perf checklist for scroll-driven work), though general validation checkpoints are implicit. | 4 / 5 |
Progressive Disclosure | Clear overview routes to per-folder recipe READMEs and four real, one-level-deep reference files (api-matrix.md, animation-curves.md, liquid-glass.md, performance.md) with a navigation table; minor gap is that the referenced recipe folders (on-scroll/, on-tap/, etc.) are not present in the bundle. | 4 / 5 |
Total | 17 / 20 Passed |