mcpField
G
guide-swiftdata

guide-swiftdata

github.com/prisma-labs-devDevelopment349454 installsUpdated 5w ago
Repository

About guide-swiftdata

A workflow guide for writing and reviewing SwiftData code, aimed at Swift developers who want modern API usage and project-consistent checks. Its topic-specific references cover core rules, predicates, CloudKit, indexing, and model inheritance.

Key features

  1. 01SwiftData correctness reviews
  2. 02Modern Swift concurrency guidance
  3. 03Predicate safety checks
  4. 04CloudKit constraint checks
  5. 05Indexing and inheritance guidance

Use cases

  1. 01Reviewing SwiftData model changes
  2. 02Checking predicates for runtime risks
  3. 03Assessing CloudKit model constraints
  4. 04Finding indexing opportunities

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/prisma-labs-dev/apple-skills --skill guide-swiftdata

After installing, type/guide-swiftdatain Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

references/
class-inheritance.md
cloudkit.md
core-rules.md
indexing.md
predicates.md

Details

From the project README

Guide Skill — This is an expert workflow/pattern guide, not API reference documentation. Originally from twostraws/SwiftData-Agent-Skill by Paul Hudson. MIT License.

SwiftData Patterns

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.

Core Instructions

  • Target Swift 6.2 or later, using modern Swift concurrency.
  • Prefer SwiftData across the board. Do not suggest Core Data unless the feature cannot be solved with SwiftData.
  • Do not introduce third-party frameworks without asking first.

Review Process

  1. Check for core SwiftData issues using references/core-rules.md.
  2. Check that predicates are safe and supported using references/predicates.md.
  3. If the project uses CloudKit, check for CloudKit-specific constraints using references/cloudkit.md.
  4. If the project targets iOS 18+, check for indexing opportunities using references/indexing.md.
  5. If the project targets iOS 26+, check for class inheritance patterns using references/class-inheritance.md.

If doing partial work, load only the relevant reference files.

References

TopicReference
Autosave, relationships, delete rules, @Query restrictions, #Unique, @Transientreferences/core-rules.md
Supported predicates, dangerous patterns that crash at runtime, unsupported methodsreferences/predicates.md
CloudKit constraints: no #Unique, optional requirements, eventual consistencyreferences/cloudkit.md
Database indexing (iOS 18+), single and compound property indexesreferences/indexing.md
Model subclassing (iOS 26+), @available requirements, predicate filteringreferences/class-inheritance.md

Comments

Markdown supported