desktop-ux-conventions

Provide platform-specific UX conventions for macOS, Windows, and Linux desktop applications.

6|1|Updated Feb 27, 2026
One-click install
npx skills add https://github.com/RepairYourTech/cfsa-antigravity --skill desktop-ux-conventions
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: desktop-ux-conventions
Source: https://github.com/RepairYourTech/cfsa-antigravity/tree/main/.agent/skill-library/surface/desktop/desktop-ux-conventions
Command: npx skills add https://github.com/RepairYourTech/cfsa-antigravity --skill desktop-ux-conventions

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill ensures desktop applications adhere to platform-specific user experience conventions, leading to a more intuitive and native feel for users on macOS, Windows, and Linux.

Core Features & Use Cases

  • Platform Consistency: Provides guidelines for window management, keyboard shortcuts, menu structures, and interaction patterns specific to each major desktop OS.
  • UX Auditing: Helps identify inconsistencies in an application's user interface compared to established platform standards.
  • Use Case: When designing a new cross-platform desktop application, use this Skill to ensure that the placement of close buttons, the behavior of the Quit command, and the structure of preference menus align with user expectations on macOS, Windows, and Linux respectively.

Quick Start

Review the provided guidelines to ensure the application's window close behavior matches macOS conventions.

Frequently Asked Questions about desktop-ux-conventions

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

FAQPage Schema
How do I ensure my desktop app follows native UX conventions for macOS, Windows, and Linux?

Native desktop app UX is achieved by following platform-specific conventions for window management, keyboard shortcuts, and menus. This Skill provides guidelines to align your application's interaction patterns with macOS, Windows, and Linux standards.

What are the differences in window close behavior between macOS and Windows desktop applications?

Window close behavior differs significantly between macOS and Windows desktop applications. macOS typically keeps the application running when the last window closes, while Windows usually terminates the application, requiring distinct event handling logic per platform.

How do I implement platform-specific keyboard shortcuts and menu structures in TypeScript?

You can implement platform-specific keyboard shortcuts and menus in TypeScript by referencing the provided code examples. These examples demonstrate how to conditionally apply interaction patterns and menu structures based on the detected desktop operating system.

Can I audit my existing cross-platform desktop application for UI inconsistencies against native standards?

You can audit an existing cross-platform desktop application for UI inconsistencies. The guidelines help identify mismatches in your interface compared to established native standards for menus, preferences, and interaction patterns.

Does this provide guidance on implementing dark mode and preferences for cross-platform desktop apps?

Yes, it provides guidance on implementing dark mode and preferences for cross-platform desktop apps. The guidelines cover the structure of preference menus and dark mode behaviors to ensure a native look and feel on macOS, Windows, and Linux.