ios-26-platform — Claude Code skill: features and installation
The ios-26-platform skill guides iOS 26 feature work in SwiftUI and helps preserve support for iOS 17/18. Use it when updating an interface or handling backward compatibility.
MIT ★ 233 updated 2026-01-18
/plugin marketplace add johnrogers/claude-swift-engineering
/plugin install swift-engineering@claude-swift-engineeringWhat ios-26-platform does
The skill covers Liquid Glass, newer SwiftUI APIs such as WebView and Chart3D, and compatibility with iOS 17/18. It helps decide where glass effects belong, when to guard APIs by availability, and what to consider for animations and accessibility settings.
Its workflow and reference material cover Liquid Glass, automatic interface adoption, SwiftUI APIs, navigation, and backward compatibility. Liquid Glass requires an iOS 26+ deployment target. To keep iOS 17/18 support, guard newer APIs with if #available(iOS 26, *); without those checks, older versions can break.
The guidance also calls for testing effects on devices and checking Reduce Transparency, Increase Contrast, and Reduce Motion. It recommends reserving glass effects for navigation rather than content areas.
What it helps with
- add Liquid Glass to navigation elements
- choose between Regular and Clear variants
- guard new SwiftUI APIs by OS availability
- preserve iOS 17/18 support while adopting iOS 26 features
- check animation behavior against accessibility settings
Example prompts for the agent
- Add Liquid Glass to the tab bar and guard it for iOS 26 and later.
- Use
WebViewandChart3Dwhile keeping the app compatible with iOS 17 and 18. - Review where the Clear variant fits and account for Reduce Motion in animations.
How to install ios-26-platform
1Plugin marketplace
/plugin marketplace add johnrogers/claude-swift-engineering/plugin install swift-engineering@claude-swift-engineeringThis installs the whole swift-engineering plugin with all its skills
2Skills CLI (Vercel)
npx skills add johnrogers/claude-swift-engineering --skill ios-26-platform -a claude-code3Manually: put the files in place
~/.claude/skills/ios-26-platform/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/ios-26-platform/
1Skills CLI (Vercel)
npx skills add johnrogers/claude-swift-engineering --skill ios-26-platform -a codex2Manually: put the files in place
.agents/skills/ios-26-platform/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add johnrogers/claude-swift-engineering --skill ios-26-platform -a cursor2Manually: put the files in place
.cursor/skills/ios-26-platform/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install johnrogers/claude-swift-engineering plugins/swift-engineering/skills/ios-26-platform2Manually: put the files in place
.github/skills/ios-26-platform/SKILL.md1Skills CLI (Vercel)
npx skills add johnrogers/claude-swift-engineering --skill ios-26-platform -a gemini-cli2Platform CLI
gemini skills install https://github.com/johnrogers/claude-swift-engineering --path plugins/swift-engineering/skills/ios-26-platformManually: put the files in place
.devin/skills/ios-26-platform/SKILL.mdThe legacy .windsurf/skills/ path still works
Claude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about ios-26-platform
How do I install ios-26-platform in Claude Code?
Add the marketplace with /plugin marketplace add johnrogers/claude-swift-engineering, then install the plugin with /plugin install swift-engineering@claude-swift-engineering.
What does ios-26-platform do?
It guides implementation of iOS 26 features such as Liquid Glass and newer SwiftUI APIs, while covering support for iOS 17/18.
How can I keep support for iOS 17 and 18?
Guard Liquid Glass and newer APIs with if #available(iOS 26, *). Skipping those checks can break support for older iOS versions.
Source text
SKILL.md · MIT
--- name: ios-26-platform description: Use when implementing iOS 26 features (Liquid Glass, new SwiftUI APIs, WebView, Chart3D), deploying iOS 26+ apps, or supporting backward compatibility with iOS 17/18. --- # iOS 26 Platform iOS 26 introduces Liquid Glass, Apple's next-generation material design system that dynamically bends light, moves organically, and adapts automatically across all platforms. ## Overview iOS 26 modernizes UI with new materials (Liquid Glass), SwiftUI APIs (WebView, Chart3D, @Animatable), and advanced features (@BackoffAnimation, free-form windows). The core principle: modern UI gets updated automatically at compile time; most Liquid Glass benefits are "free" from recompiling with Xcode 26. ## Reference Loading Guide **ALWAYS load reference files if there is even a small chance the content may be required.** It's better to have the context than to miss a pattern or make a mistake. | Reference | Load When | |-----------|-----------| | **[Liquid Glass](references/liquid-glass.md)** | Implementing glass effects, choosing Regular vs Clear variants, or understanding visual properties | | **[Automatic Adoption](references/automatic-adoption.md)** | Understanding what iOS 26 changes automatically vs what requires code | | **[SwiftUI APIs](references/swiftui-apis.md)** | Using WebView, Chart3D, `@Animatable`, AttributedString, or new view modifiers | | **[Toolbar & Navigation](references/toolbar-navigation.md)** | Customizing toolbars with spacers, morphing, glass button styles, or search | | **[Backward Compatibility](references/backward-compat.md)** | Supporting iOS 17/18 alongside iOS 26, or using UIDesignRequiresCompatibility | ## Core Workflow 1. **Check deployment target** — iOS 26+ required for Liquid Glass 2. **Recompile with Xcode 26** — Standard controls get glass automatically 3. **Identify navigation layer** — Apply glass to tab bars, toolbars, navigation (not content) 4. **Choose variant** — Regular (95% of cases) or Clear (media-rich backgrounds only) 5. **Add @available guards** — For backward compatibility with iOS 17/18 6. **Test accessibility** — Verify Reduce Transparency, Increase Contrast, Reduce Motion ## Common Mistakes 1. **Ignoring backward compatibility** — Targeting iOS 26+ without `@available` guards breaks iOS 17/18 support. Always use `if #available(iOS 26, *)` for Liquid Glass or new APIs. 2. **Over-using glass effect** — Applying glass to content areas, not just navigation, creates visual noise. Glass works for: tab bars, toolbars, sheets, navigation. NOT for content areas. 3. **Animation performance issues** — Liquid Glass animations can be expensive. Respect Reduce Motion accessibility setting and profile with Instruments 26 before shipping. 4. **Assuming Clear variant looks good** — Clear is for media-rich backgrounds only (photos, video). Regular variant is correct 95% of the time. Only use Clear if you explicitly need the ultra-transparency. 5. **Not testing on actual devices** — Simulator rendering differs from hardware. Test glass effects on iPhone 15 Pro, iPad, and Mac to verify visual quality. 6. **Using old UIView patterns with new glass** — Mixing UIView-based navigation with iOS 26 glass creates inconsistent appearances. Migrate fully to SwiftUI or wrap carefully with UIViewRepresentable.
© John Rogers (@johnrogers) · MIT · johnrogers/claude-swift-engineering