playbooks

home / skills / fusengine / agents / ipados

ipados skill

/plugins/swift-apple-expert/skills/ipados

This skill helps iPadOS developers optimize app architecture for split views, Stage Manager, and external keyboard support with adaptive layouts.

npx playbooks add skill fusengine/agents --skill ipados

Review the files below or copy the command above to add this skill to your agents.

Files (4)
SKILL.md
2.0 KB
---
name: ipados
description: iPadOS platform-specific development with adaptive layouts, keyboard shortcuts, multitasking, and Stage Manager. Use when building iPad apps with split views, external keyboard support, or multi-window features.
versions:
  ipados: 26
user-invocable: false
references: references/adaptive-layouts.md, references/keyboard-shortcuts.md, references/multitasking.md
related-skills: swift-core, swiftui-core, ios, mcp-tools
---

# iPadOS Platform

iPadOS-specific development for tablet and productivity experiences.

## Agent Workflow (MANDATORY)

Before ANY implementation, use `TeamCreate` to spawn 3 agents:

1. **fuse-ai-pilot:explore-codebase** - Analyze existing iPad patterns
2. **fuse-ai-pilot:research-expert** - Verify latest iPadOS 26 docs via Context7/Exa
3. **mcp__apple-docs__search_apple_docs** - Check iPad multitasking patterns

After implementation, run **fuse-ai-pilot:sniper** for validation.

---

## Overview

### When to Use

- Building iPad-optimized apps
- Implementing split views
- Supporting external keyboard
- Multi-window applications
- Stage Manager support
- Adaptive layouts

### Why iPadOS Skill

| Feature | Benefit |
|---------|---------|
| Split View | Side-by-side apps |
| Keyboard shortcuts | Productivity |
| Stage Manager | Desktop-like experience |
| Adaptive layouts | All iPad sizes |

---

## Reference Guide

| Need | Reference |
|------|-----------|
| Size classes, split views | [adaptive-layouts.md](references/adaptive-layouts.md) |
| External keyboard support | [keyboard-shortcuts.md](references/keyboard-shortcuts.md) |
| Slide Over, Stage Manager | [multitasking.md](references/multitasking.md) |

---

## Best Practices

1. **Size class adaptation** - Support compact and regular
2. **Keyboard shortcuts** - ⌘ shortcuts for productivity
3. **Drag and drop** - Enable data transfer
4. **Pointer support** - Mouse/trackpad cursors
5. **Multi-window** - Support multiple instances
6. **External display** - UIScreen support

Overview

This skill provides iPadOS-specific development guidance and automation for building tablet-first, productivity-focused apps. It focuses on adaptive layouts, keyboard shortcuts, multitasking, Stage Manager, and multi-window behavior. Use it to ensure apps behave correctly across iPad sizes and external input devices.

How this skill works

Before any implementation, the workflow spawns three specialist agents via TeamCreate to analyze the codebase, verify Apple documentation, and check multitasking patterns. The skill inspects app layout patterns, keyboard and pointer integrations, multi-window configuration, and Stage Manager compatibility, then recommends concrete changes. After implementation, run the validation agent to run checks and surface regressions.

When to use it

  • Building iPad-optimized apps and tablet-first interfaces
  • Implementing split views or slide-over experiences
  • Adding external keyboard shortcuts and command support
  • Enabling multi-window or Scene-based workflows
  • Supporting Stage Manager and external display behaviors

Best practices

  • Adapt to size classes: support both compact and regular layouts
  • Provide Command (⌘) keyboard shortcuts for key actions
  • Enable drag-and-drop and pointer interactions for productivity
  • Support multiple windows and scene sessions for multitasking
  • Test Stage Manager and external display scenarios across iPadOS versions

Example use cases

  • Rework a universal app to present a two-pane split view on iPad
  • Add a rich set of keyboard shortcuts and discoverability UI for external keyboards
  • Implement multi-window document editing with proper scene lifecycle handling
  • Adapt navigation and split behaviors when switching between Slide Over and Split View
  • Validate Stage Manager behavior and external monitor rendering

FAQ

What agents run before I start coding?

Use TeamCreate to spawn three agents: fuse-ai-pilot:explore-codebase, fuse-ai-pilot:research-expert, and mcp__apple-docs__search_apple_docs to analyze patterns and verify docs before implementation.

What validation step is required after changes?

After implementation, run fuse-ai-pilot:sniper to validate changes, detect regressions, and confirm multitasking and layout behaviors.