Menu
Sync guidance for an Apple .xcworkspace with Apps and Packages. Use to audit root guidance, app projects, local package wiring, XcodeGen settings, and service boundaries; not for one standalone .xcodeproj or package.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
| name | sync-xcode-workspace-guidance |
| description | Sync guidance for an Apple .xcworkspace with Apps and Packages. Use to audit root guidance, app projects, local package wiring, XcodeGen settings, and service boundaries; not for one standalone .xcodeproj or package. |
Align the root guidance for a modular Apple workspace while preserving the
separate owners of each app project and Swift package. scripts/run_workflow.py
detects the shape, audits its composition, and adds the bounded workspace
guidance section when needed.
explore-apple-swift-docs before changing workflow policy. Prefer Xcode
MCP, then Dash's usable XcodeGen : ProjectSpec archive.scripts/run_workflow.py --repo-root <root> to inspect workspace,
projects, packages, and optional services..xcworkspace, Apps/, and Packages/.
Report missing or misplaced projects and packages; do not repair project
membership by editing workspace or .pbxproj data directly.project.yml for a local packages declaration before
claiming it consumes a Core package. Check the package's Package.swift for
its real target and product graph.schemePathPrefix: "../" where
workspace-relative scheme paths are used. Keep XcodeGen per-project: it does
not become the workspace source of truth.sync-xcode-project-guidance, package-specific
guidance to sync-swift-package-guidance, and active execution to
xcode-build-run-workflow or xcode-testing-workflow.Services/ as their own deployment and runtime
boundary. Use the selected server skill for service-local policy.The runtime reports:
Package.swift;project.yml paths;AGENTS.md action taken or planned.It does not parse XcodeGen package declarations, classify topology, or change workspace membership, app target dependencies, package manifests, generated projects, or service code.
.xcworkspace, Apps/, or Packages/ marker..pbxproj or workspace data. Make Xcode/XcodeGen-aware
changes through the owner skill.references/workspace-shape.mdassets/append-section.mdDesign, implement, validate, and troubleshoot App Intents, App Entities, App Shortcuts, and system-surface integrations. Use when exposing a focused app action or content to Siri, Spotlight, Shortcuts, widgets, controls, Live Activities, or hardware interactions.
Guide AppKit app-structure decisions for macOS apps across app delegates, status-item menu bar apps, responder-chain menus, windows, controllers, restoration, archiving, Observation, and mixed AppKit/SwiftUI composition. Use when the user wants help deciding where AppKit responsibilities belong or how to avoid steering a macOS app into SwiftUI-only structure when AppKit owns the behavior.
Plan and safely automate officially supported Apple Developer provisioning and CloudKit workflows through the App Store Connect REST API, Xcode-aware local discovery, cktool, and CKTool JS. Use when inspecting or changing bundle IDs, capabilities, certificates, devices, provisioning profiles, CloudKit schemas, or sandbox test data while keeping portal-only configuration, credentials, dry runs, and confirmation gates explicit.
Guide Apple image decoding, encoding, metadata, thumbnails, multi-frame sources, and representation bridging across Image I/O, Core Graphics, AppKit NSImage and NSImageRep, UIKit UIImage, Core Image, and Core Video. Use when image work involves files, data, representations, orientation, scale, color, metadata, or conversion rather than pixel effects or visual recognition.
Guide Apple platform typography decisions and implementation across SwiftUI Font, UIKit UIFont, AppKit NSFont, San Francisco system fonts, SF Pro, SF Compact, SF Mono, SF Pro Rounded, New York serif design, Dynamic Type, text styles, fontDesign, fontWeight, fontWidth, monospaced digits, custom font bundle integration, font licensing and redistribution boundaries, accessibility scaling, and Xcode font asset validation. Use when a task mentions Apple typography, San Francisco, SF Pro, SF Compact, SF Mono, New York, Dynamic Type, UIFontMetrics, preferredFont, NSFont.TextStyle, custom fonts, UIAppFonts, ATSApplicationFontsPath, or text style repair.
Guide Apple UI accessibility implementation and review for SwiftUI-first code, with UIKit and AppKit bridge guidance plus explicit verification expectations and testing handoffs. Use when the user wants help making Apple UI accessible, reviewing accessibility semantics, shaping the accessibility tree, or planning Apple-platform accessibility verification without collapsing the work into generic design review or Xcode test execution.