desktop-find-element

Locate desktop UI elements via UIAutomation with vision fallback and return coordinates, size, and attributes.

9|2|Updated Mar 18, 2026
One-click install
npx skills add https://github.com/AllBeingsFuture/AllBeingsFuture --skill desktop-find-element-allbeingsfuture
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: desktop-find-element
Source: https://github.com/AllBeingsFuture/AllBeingsFuture/tree/main/electron/embedded-assets/skills/system/desktop-find-element
Command: npx skills add https://github.com/AllBeingsFuture/AllBeingsFuture --skill desktop-find-element-allbeingsfuture

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Locate desktop UI elements reliably so automated agents can click, verify state, or extract attributes without relying on fragile hard-coded coordinates; prefer UIAutomation for precision and fall back to vision recognition when necessary.

Core Features & Use Cases

  • UIAutomation first, vision fallback: attempt structured UIAutomation queries for fast, accurate results and use vision-based detection when UIAutomation fails or is unavailable.
  • Flexible target formats: accept natural language descriptions or explicit selectors such as name:, id:, and type: to match elements.
  • Scoped search and methods: support window-scoped searches and methods auto, uia, and vision to control discovery strategy.
  • Outputs for automation: return element coordinates, size, and attributes for downstream tools like clickers or inspectors.
  • Use case: find a Save button in a native application to obtain its position for a subsequent click action, or verify that a toggle is on before proceeding.

Quick Start

Use desktop-find-element to locate the Save button in the active window and return its coordinates, size, and attributes.

Frequently Asked Questions about desktop-find-element

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

FAQPage Schema
How do I locate desktop UI elements for automation without using hard-coded screen coordinates?

To locate desktop UI elements without hard-coded screen coordinates, query UIAutomation first for structured attributes and fall back to vision recognition to detect visual elements. This returns precise coordinates, size, and attributes for reliable automated interactions.

What is the best way to find a native application button using UIAutomation when standard queries fail?

The best way to find a native button when UIAutomation queries fail is to use a vision-based detection fallback. Setting the method to vision or auto applies vision recognition to visually locate the button and return its screen coordinates.

Can I scope desktop element searches to a specific window using natural language descriptions?

Yes, you can scope desktop element searches to a specific window using the window_title parameter. You can provide natural language descriptions or explicit selectors like name, id, and type to match elements within that window.

Does UIAutomation work for locating in-page browser elements during desktop automation?

UIAutomation does not work for in-page browser elements as this task targets native desktop applications. It is specifically designed for window-scoped native UI tasks such as clicking buttons, verifying UI state, and locating menus or icons.

How do I get element coordinates and size for a downstream click action in native desktop apps?

To get coordinates and size for downstream click actions, apply UIAutomation queries or vision-based detection to the native desktop app. The process outputs precise screen coordinates, element size, and attributes required for automated clicking tools.

Why does my desktop GUI automation fail to find a toggle or icon even when I use UIAutomation?

Desktop GUI automation fails to find toggles or icons when UIAutomation cannot access the element's structure. Switching the method to vision applies vision recognition fallback to visually detect the element and retrieve its position.