macos-window-management

Customize macOS SwiftUI window appearance, behavior, and placement.

46|5|Updated Jan 14, 2026
One-click install
npx skills add https://github.com/robinebers/skills --skill macos-window-management
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: macos-window-management
Source: https://github.com/robinebers/skills/tree/main/skills/macos-window-management
Command: npx skills add https://github.com/robinebers/skills --skill macos-window-management

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill addresses the challenge of customizing macOS SwiftUI windows, providing tools to fine-tune window chrome, drag regions, placement, and behavior to meet specific application requirements.

Core Features & Use Cases

  • Window Customization: Adjust window titles, toolbars, and backgrounds.
  • Drag Region Extensions: Extend the draggable area of windows.
  • Background Materials: Apply system materials or custom backgrounds.
  • Window Behavior: Control minimize, zoom, and restoration behavior.
  • Placement Policies: Define default and ideal window placement.
  • Borderless Windows: Implement borderless window styles.
  • Use Case: When creating a media player application, you can use this Skill to set up a borderless window with a custom drag region and a frosted background material.

Quick Start

Use the macos-window-management skill to customize the window for the 'Media Player' app by setting the window style to borderless and disabling window zooming.

Frequently Asked Questions about macos-window-management

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create a borderless macOS SwiftUI window with custom drag regions?

Borderless window styles in macOS SwiftUI are implemented by applying specific window styles and extending draggable areas using macOS-specific APIs. This Skill configures custom drag regions and window chrome for applications like media players.

Can I apply custom background materials to a SwiftUI window on macOS?

Yes, custom background materials can be applied to a macOS SwiftUI window. This Skill handles configuring background materials, allowing you to set frosted backgrounds and custom appearances for your application windows.

Does macOS SwiftUI window customization require a specific macOS or SwiftUI version?

Yes, macOS SwiftUI window customization requires SwiftUI 15+ and macOS-specific APIs. This Skill relies on these dependencies to fine-tune window behavior, placement, and scene ownership for various application roles.

How do I control window placement and zoom behavior in a macOS SwiftUI app?

Window placement and zoom behavior are controlled by defining placement policies and managing window restoration. This Skill configures ideal default placement and adjusts zooming behavior for utility windows.

What is the best way to manage scene ownership for different window roles in SwiftUI?

Managing scene ownership for different window roles involves using macOS-specific APIs to handle varying window behaviors. This Skill customizes scene ownership for navigation hubs, utility windows, and media players in SwiftUI.