home / skills / fusengine / agents / tvos
This skill helps you build tvOS apps with focus-based navigation, Liquid Glass UI, and media playback by guiding patterns and best practices.
npx playbooks add skill fusengine/agents --skill tvosReview the files below or copy the command above to add this skill to your agents.
---
name: tvos
description: tvOS platform-specific development with focus system, large screen UI, Siri Remote, and media playback. Use when building Apple TV apps, video streaming, or living room experiences.
versions:
tvos: 26
user-invocable: false
references: references/focus-system.md, references/media-playback.md, references/remote-control.md
related-skills: swift-core, swiftui-core, mcp-tools
---
# tvOS Platform
tvOS-specific development for Apple TV living room experiences.
## Agent Workflow (MANDATORY)
Before ANY implementation, use `TeamCreate` to spawn 3 agents:
1. **fuse-ai-pilot:explore-codebase** - Analyze existing tvOS patterns
2. **fuse-ai-pilot:research-expert** - Verify latest tvOS 26 docs via Context7/Exa
3. **mcp__apple-docs__search_apple_docs** - Check tvOS patterns
After implementation, run **fuse-ai-pilot:sniper** for validation.
---
## Overview
### When to Use
- Building Apple TV applications
- Video and audio streaming
- Focus-based navigation
- Siri Remote interactions
- Multi-user experiences
- Game controller support
### Why tvOS Skill
| Feature | Benefit |
|---------|---------|
| Focus system | Large screen navigation |
| Liquid Glass | Modern TV UI (tvOS 26) |
| Media playback | AVKit integration |
| Remote control | Siri Remote gestures |
---
## tvOS 26 Features
### Liquid Glass on TV
```swift
Button("Watch Now") { }
.buttonStyle(.bordered)
.glassEffect(.regular) // Glass effect on focus
TabView {
// Tab bar with Liquid Glass
}
```
### Focus System
```swift
struct ContentView: View {
@FocusState private var focused: Bool
var body: some View {
Button("Play") { }
.focused($focused)
.scaleEffect(focused ? 1.1 : 1.0)
}
}
```
---
## Reference Guide
| Need | Reference |
|------|-----------|
| Focus, selection states | [focus-system.md](references/focus-system.md) |
| AVKit, video playback | [media-playback.md](references/media-playback.md) |
| Siri Remote, gestures | [remote-control.md](references/remote-control.md) |
---
## Best Practices
1. **Large UI elements** - Readable from 10 feet
2. **Focus feedback** - Clear visual indication
3. **Simple navigation** - Minimal depth
4. **Remote-friendly** - Siri Remote gestures
5. **Media-first** - Optimize for video/audio
6. **Multi-user** - Support user switching
This skill targets tvOS platform development with a focus on large-screen UI, the focus system, Siri Remote interactions, and robust media playback. It provides practical guidance and patterns for building Apple TV apps, streaming experiences, and living-room interactions. Use it to accelerate implementation of tvOS 26 features like Liquid Glass and AVKit integration.
Before implementation, spawn three agents via TeamCreate to analyze the codebase, verify tvOS 26 documentation, and check platform patterns: fuse-ai-pilot:explore-codebase, fuse-ai-pilot:research-expert, and mcp__apple-docs__search_apple_docs. Use the skill to inspect focus management, large UI layout, remote gesture handling, and AVKit playback integration, then implement view and control patterns accordingly. After development, run fuse-ai-pilot:sniper to validate patterns, focus behavior, and media flows across devices.
Do I need to change layouts for tvOS 26?
Yes. Update controls to use larger hit targets, adopt Liquid Glass effects where appropriate, and verify focus states under tvOS 26 guidelines.
How should I validate focus behavior?
Use the required agent workflow to analyze patterns, implement focusable components with FocusState, and run fuse-ai-pilot:sniper to validate real-device focus transitions and animations.