desktop-app-flows

Validate macOS desktop UI flows using YAML-defined steps.

Updated Apr 19, 2026
One-click install
npx skills add https://github.com/tsukuru-86/Comm0ns-omi --skill desktop-app-flows
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: desktop-app-flows
Source: https://github.com/tsukuru-86/Comm0ns-omi/tree/main/desktop/e2e
Command: npx skills add https://github.com/tsukuru-86/Comm0ns-omi --skill desktop-app-flows

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Validating desktop UI flows for Omi macOS requires consistent navigation, predictable widget behaviors, and reliable flow coverage across multiple screens. This skill provides a structured approach to exploring and verifying the app's architecture, interaction patterns, and end-to-end journeys to prevent regressions.

Core Features & Use Cases

  • End-to-end flow coverage for core screens including Dashboard, Chat, Memories, Tasks, Rewind, Apps, and Settings.
  • Agent-driven accessibility-based UI exploration using agent-swift to interact with elements, read state, and capture evidence.
  • Reproducible flow plans (YAML-based) with preconditions, steps, expectations, and reports to guide QA, development, and design reviews.

Quick Start

Run the E2E flow suite by loading the YAMLs under flows and executing agent-swift to validate the desktop UI flows.

Frequently Asked Questions about desktop-app-flows

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

FAQPage Schema
How do I automate end-to-end testing for macOS desktop UI flows?

Automate macOS desktop UI flows by defining preconditions, steps, and expectations in YAML files, then executing them with agent-swift to interact with elements, read state, and capture evidence. This structured approach validates navigation and detects regressions across app versions.

What is YAML-based flow validation for macOS apps?

YAML-based flow validation structures end-to-end UI testing by defining preconditions, steps, expectations, and reports in YAML files. It guides agent-swift to perform deterministic automation, ensuring predictable widget behaviors and reliable coverage across multiple desktop screens.

Can I use agent-swift to test macOS settings and navigation workflows?

Yes, agent-swift drives accessibility-based UI exploration to test macOS settings and navigation workflows. It interacts with elements, reads state, and captures evidence across core screens including Dashboard, Chat, Memories, Tasks, Rewind, Apps, and Settings.

How do I prevent UI regressions across macOS desktop app versions?

Prevent macOS desktop UI regressions by running reproducible YAML-based flow plans that coordinate preconditions, steps, and expected outcomes. This structured validation ensures consistent UX across versions by detecting navigation and interaction failures.

Does this UI testing approach require a specific flows directory structure?

Yes, it requires a defined flows directory to coordinate preconditions, steps, and expected outcomes. The deterministic automation via agent-swift relies on loading YAML files from this directory to execute the end-to-end validation suite.

What are the limitations of accessibility-based UI exploration for desktop testing?

Accessibility-based UI exploration requires deterministic automation via agent-swift and structured YAML flow definitions. Without properly defined preconditions and expected outcomes in the flows directory, the validation may not reliably detect regressions or capture consistent evidence.