Paul Hudson built this to catch the SwiftData mistakes that actually break things at runtime, not style nitpicks. It reviews your models and queries against a set of reference files covering core rules, predicate safety, CloudKit constraints, and iOS 18+ indexing. The output is organized by file with before/after fixes and a prioritized summary of what will cause crashes or data loss versus what's just suboptimal. Useful if you're working on a real SwiftData project and want to avoid the predicate gotchas and relationship bugs that only show up when users start deleting things. Targets Swift 6.2 and modern concurrency throughout.
npx -y skills add twostraws/swiftdata-agent-skill --skill swiftdata-pro --agent claude-codeInstalls into .claude/skills of the current project.
Write and review SwiftData code for correctness, modern API usage, and adherence to project conventions. Report only genuine problems - do not nitpick or invent issues.
Review process:
references/core-rules.md.references/predicates.md.references/cloudkit.md.references/indexing.md.references/class-inheritance.md.If doing partial work, load only the relevant reference files.
If the user asks for a review, organize findings by file. For each issue:
Skip files with no issues. End with a prioritized summary of the most impactful changes to make first.
If the user asks you to write or improve code, follow the same rules above but make the changes directly instead of returning a findings report.
Example output:
Line 8: Add an explicit delete rule for relationships.
// Before
var sights: [Sight]
// After
@Relationship(deleteRule: .cascade, inverse: \Sight.destination) var sights: [Sight]
Line 22: Do not use isEmpty == false in predicates – it crashes at runtime. Use ! instead.
// Before
#Predicate<Destination> { $0.sights.isEmpty == false }
// After
#Predicate<Destination> { !$0.sights.isEmpty }
Line 5: @Query must only be used inside SwiftUI views.
// Before
class DestinationStore {
@Query var destinations: [Destination]
}
// After
class DestinationStore {
var modelContext: ModelContext
func fetchDestinations() throws -> [Destination] {
try modelContext.fetch(FetchDescriptor<Destination>())
}
}
isEmpty == false on line 22 will crash at runtime – use !isEmpty instead.@Query on line 5 of DestinationListView.swift only works inside SwiftUI views.End of example.
references/core-rules.md - autosaving, relationships, delete rules, property restrictions, and FetchDescriptor optimization.references/predicates.md - supported predicate operations, dangerous patterns that crash at runtime, and unsupported methods.references/cloudkit.md - CloudKit-specific constraints including uniqueness, optionality, and eventual consistency.references/indexing.md - database indexing for iOS 18+, including single and compound property indexes.references/class-inheritance.md - model subclassing for iOS 26+, including @available requirements, schema setup, and predicate filtering.sickn33/antigravity-awesome-skills
moizibnyousaf/ai-agent-skills
github/awesome-copilot