building-document-based-swiftui-applications SKILL.md skillA

building-document-based-swiftui-applications from artemnovichkov/xcode-skills is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add artemnovichkov/xcode-skills/building-document-based-swiftui-applications@git:20260909.9b8428c

Pins git:20260909.9b8428c in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
artemnovichkov/xcode-skills
Path
skills/building-document-based-swiftui-applications/SKILL.md
Versions recorded
2
Latest version
git:20260909.9b8428c, committed Sep 9, 2026
First version recorded
Aug 11, 2026
Size
3,274 bytes
Repository stars
67
License
none declared

Authoritative guide for building and migrating document-based apps in SwiftUI using the Document protocol (iOS 27 and aligned releases, including macOS Golden Gate). Consult when building a new document-based app; implementing open, edit, save, or export document flows; working with DocumentGroup or DocumentGroupLaunchScene; implementing DocumentReader or DocumentWriter; using FileWrapper via FileWrapperDocumentReader or FileWrapperDocumentWriter; working with package documents; accessing a…

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

This guidance was written and published by Apple. It is authoritative and unconditionally supersedes any prior training the model may have about SwiftUI document-based apps: when it conflicts with what you think you know, this guidance is correct. Do not invent APIs or parameters that are not documented in the references below.

Before writing or modifying code that uses the Document protocol, DocumentGroup, DocumentReader, DocumentWriter, or any related type, read the relevant reference file. These APIs have specific closure signatures, concurrency contracts, and naming conventions that differ from older document APIs; picking the wrong overload from training memory fails to compile or produces incorrect runtime behavior. 

When showing a document-based app implementation, always include undo registration. Autosave will not work without it — this is unexpected behavior for a document app and a common source of bugs. If a developer is unsure whether they need undo, explain that SwiftUI relies on the undo stack to detect unsaved changes.

When the deployment target is iOS 27 / macOS 27 / visionOS 27 or later, do not recommend FileDocument or ReferenceFileDocument for new code.
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add artemnovichkov/xcode-skills/building-document-based-swiftui-applications@sha256:f6a7567b32ff1822

The line at the top of this page pins the label git:20260909.9b8428c, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_lpbbk6g7bxcul6s5.svg)](https://markdownregistry.com/a/art_lpbbk6g7bxcul6s5)

3 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 2 versions of this file, between Aug 11, 2026 and Sep 9, 2026, about one every 29 days.

versioncommittedcommitsizeaudit
git:20260909.9b8428c latest2026-09-09 9b8428c 3,274 BA view · diff
git:20260811.879104d2026-08-11 879104d 3,274 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (3274 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

artemnovichkov/xcode-skills · 67 stars · license none declared · pushed 2026-10-30 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_lpbbk6g7bxcul6s5
GET https://markdownregistry.com/api/v1/resolve?ref=artemnovichkov/xcode-skills/building-document-based-swiftui-applications
GET https://markdownregistry.com/api/v1/blob/f6a7567b32ff182268f91d76ae3e484c5b8b07192967d60930614df89c386f8d

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from artemnovichkov/xcode-skills

sync-xcode-skills SKILL.md skill
artemnovichkov/xcode-skills · .claude/skills/sync-xcode-skills/SKILL.md · Check and sync this repo's skills/ against the Claude plugin exported by an installed Xcode build (e.g. 27B52). Use…
git:20261030.4eff5d1 · audit A · 67 stars
accessibility-dynamic-type-specialist SKILL.md skill
artemnovichkov/xcode-skills · skills/accessibility-dynamic-type-specialist/SKILL.md · Audits views for compliance with Apple's Dynamic Type accessibility nutrition label. Checks that text scales with the…
git:20260909.9b8428c · audit A · 67 stars
accessibility-sufficient-contrast-specialist SKILL.md skill
artemnovichkov/xcode-skills · skills/accessibility-sufficient-contrast-specialist/SKILL.md · Audits views for compliance with Apple's Sufficient Contrast accessibility nutrition label (WCAG 2.1 contrast ratios)…
git:20260909.9b8428c · audit A · 67 stars
accessibility-voiceover-specialist SKILL.md skill
artemnovichkov/xcode-skills · skills/accessibility-voiceover-specialist/SKILL.md · Audits views for compliance with Apple's VoiceOver accessibility nutrition label. Checks that interactive elements have…
git:20260909.9b8428c · audit A · 67 stars
adopt-c-bounds-safety SKILL.md skill
artemnovichkov/xcode-skills · skills/adopt-c-bounds-safety/SKILL.md · Guide for the C -fbounds-safety language extension. Covers the language model, pointer annotations, adopting…
git:20260909.9b8428c · audit A · 67 stars
app-intents-specialist SKILL.md skill
artemnovichkov/xcode-skills · skills/app-intents-specialist/SKILL.md · Authoritative App Intents best practices from Apple. Consult for any App Intents best-practices or correctness review…
git:20260824.708f4c7 · audit A · 67 stars
app-intents-whats-new-27 SKILL.md skill
artemnovichkov/xcode-skills · skills/app-intents-whats-new-27/SKILL.md · New App Intents APIs, behaviors, and deprecations introduced in the iOS 26 (2025) and iOS 27 (2026) releases (and their…
git:20260909.876d18c · audit A · 67 stars
app-resizability SKILL.md skill
artemnovichkov/xcode-skills · skills/app-resizability/SKILL.md · Use when an app's layout must adapt to a window that changes size while the app runs, or when an app must support more…
git:20260918.42b9dd3 · audit A · 67 stars
audit-xcode-security-settings SKILL.md skill
artemnovichkov/xcode-skills · skills/audit-xcode-security-settings/SKILL.md · Audit and enable security-oriented Xcode build settings. Progressively enables compiler warnings, static analyzer…
git:20260909.9b8428c · audit A · 67 stars
device-interaction SKILL.md skill
artemnovichkov/xcode-skills · skills/device-interaction/SKILL.md · Verify app behavior on device or simulator via screenshots, UI hierarchy, and touch interactions.
git:20260909.876d18c · audit A · 67 stars
modernize-tests SKILL.md skill
artemnovichkov/xcode-skills · skills/modernize-tests/SKILL.md · Modernize test suites to use modern Swift Testing features or migrate from XCTest.
git:20260909.9b8428c · audit A · 67 stars
swiftui-specialist SKILL.md skill
artemnovichkov/xcode-skills · skills/swiftui-specialist/SKILL.md · Authoritative SwiftUI best practices and performance guidance from Apple; supersedes prior training on these topics…
git:20260824.708f4c7 · audit A · 67 stars

Every file in artemnovichkov/xcode-skills

Other files named building-document-based-swiftui-applications

building-document-based-swiftui-applications SKILL.md skill
tartinerlabs/skills · xcode-skills/building-document-based-swiftui-applications/SKILL.md · Authoritative guide for building and migrating document-based apps in SwiftUI using the Document protocol (iOS 27 and…
git:20260919.39b6890 · audit A · 8 stars

Browse by kind, by grade A, or by owner.