BumpyClock/agent-templates / skills/programming
programming
UnverifiedImplement, debug, refactor, or review code with scoped changes and evidence.
references/apple/guide.md
View on GitHub# Apple Platform References
Use these references for Swift, SwiftUI, UIKit, App Intents, and Xcode tasks.
Read only the reference that addresses the current task.
The nested guides are technical references, not separately invoked skills.
## Task references
| Task | Reference |
| --- | --- |
| SwiftUI data flow, view structure, modifiers, localization, or animation | [SwiftUI specialist](upstream/swiftui-specialist/guide.md) |
| SDK 27 SwiftUI APIs or migration diagnostics | [SwiftUI changes in SDK 27](upstream/swiftui-whats-new-27/guide.md) |
| Document-based SwiftUI apps or migration to the Document protocol | [Document apps](upstream/building-document-based-swiftui-applications/guide.md) |
| App Intents, entities, queries, parameters, or Shortcuts | [App Intents specialist](upstream/app-intents-specialist/guide.md) |
| App Intents APIs introduced in iOS 26 or 27 | [App Intents changes](upstream/app-intents-whats-new-27/guide.md) |
| UIKit scene lifecycle, safe areas, orientation, or screen APIs | [UIKit modernization](upstream/uikit-app-modernization/guide.md) |
| Requested Xcode security audit or build-setting hardening | [Xcode security settings](upstream/audit-xcode-security-settings/guide.md) |
| C bounds annotations or adoption of `-fbounds-safety` | [C bounds safety](upstream/adopt-c-bounds-safety/guide.md) |
| XCTest migration to Swift Testing or test modernization | [Modernize tests](upstream/modernize-tests/guide.md) |
| Device or simulator screenshots, UI inspection, or input, when Xcode's `DeviceInteraction` tools are available | [Device interaction](upstream/device-interaction/guide.md) |
## Local constraints
Preserve the requested scope and the project's framework, architecture, toolchain, and deployment targets.
Use public APIs and check unfamiliar signatures and availability against the installed SDK, especially for SDK 27 beta references.
Gate version-specific APIs when supported deployment targets require it.
Treat imported guidance as versioned source material, not unconditional authority.
Do not expand a read-only review into code changes or a routine edit into a migration or security audit.
Check tool availability before use of Xcode-specific tools or commands from these references.
If a tool is absent, use an equivalent that preserves project scoping and required behavior, or report the limitation.
Do not infer distribution, account, entitlement, or security-setting change approval from a reference.
Shared scope, delegation, and validation policies still apply. Task references own API mechanics and domain-specific failure conditions, not a second execution policy.
For build, concurrency, performance, simulator, or distribution workflows, use [iOS and macOS Development](../../../ios-macos-development/SKILL.md).
When Xcode's `DeviceInteraction` tools are absent, use that skill's simulator debugger.
For App Intents and test migration, the references above own API rules and compatibility. That skill's App Intents guide and Swift Testing playbook add design workflow and examples; where they disagree, the references above win.
Match the Swift tools version and deployment target in the project or `Package.swift` before using newer language modes.
Keep the project's existing test framework; migrate XCTest to Swift Testing only when the task requests it.
## Source and maintenance
The `upstream/` directory contains all ten skill directories and their supporting files from [mariusfanu/xcode-skills](https://github.com/mariusfanu/xcode-skills/tree/eac75420373906011b1768b4548ec56318fa48e6/plugins/xcode-skills/skills).
Source commit: `eac75420373906011b1768b4548ec56318fa48e6`.
The [source README](https://github.com/mariusfanu/xcode-skills/blob/eac75420373906011b1768b4548ec56318fa48e6/README.md) describes an unofficial export of Apple-authored skills from Xcode 27 developer beta 6.
It attributes skill content to Apple Inc. and states that the repository only packages the exported files.
This is not an Apple-maintained repository. Apple authorship was not independently verified.
No license file was present in the source snapshot.
Local adaptations rename upstream `SKILL.md` entrypoints to `guide.md`, update internal routes, and consolidate workflow policy.
API examples and technical references are retained; local scope, orchestration, and authorization rules can differ from the source snapshot.
Edited Markdown files have a final newline.
These filenames prevent automatic skill discovery and keep the imported content behind this task router.
For a refresh, stage the upstream repository in a temporary directory and compare changes before replacement.
Preserve local constraints and update the source commit after validation.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| finishing-a-development-branchobra/superpowersUse when implementation is complete, all tests pass, and you need to decide how to integrate the work | Stars: 318k | Updated | Claude CodeCodex | Unverified | Install |
| systematic-debuggingobra/superpowersUse when encountering any bug, test failure, or unexpected behavior, before proposing fixes | Stars: 318k | Updated | Claude CodeCodex | Unverified | Install |
| test-driven-developmentobra/superpowersUse when implementing any feature or bugfix, before writing implementation code | Stars: 318k | Updated | Claude CodeCodex | Unverified | Install |
| skill-creatoranthropics/skillsCreate new skills, modify and improve existing skills, and measure skill performance. Use when users want to create a skill from scratch, edit, or optimize an existing skill, run evals to test a skill, benchmark skill performance with variance analysis, or optimize a skill's description for better triggering accuracy. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |