desktop-navigation-agent

Analyze desktop header screenshots to produce structured JSON navigation rows.

Updated Mar 16, 2026
One-click install
npx skills add https://github.com/aemdemos/summit-dsg --skill desktop-navigation-agent
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: desktop-navigation-agent
Source: https://github.com/aemdemos/summit-dsg/tree/main/.agents/skills/excat-navigation-orchestrator/desktop-navigation-agent
Command: npx skills add https://github.com/aemdemos/summit-dsg --skill desktop-navigation-agent

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Analyzes desktop header screenshots to count rows and map each row to a structured JSON representation of the navigation layout, enabling deterministic validation of desktop navigation without assumptions. This tool is invoked by excat-navigation-orchestrator and should not be used for mobile navigation or non-header screenshots.

Core Features & Use Cases

  • Detects row count and alignment groups in desktop headers (logos, nav items, locale selectors) and outputs a strict JSON payload.
  • Maps each detected row to a structured representation for downstream automation and QA.
  • Invoked by excat-navigation-orchestrator to validate desktop navigation structures; not intended for mobile nav or non-header screenshots.

Quick Start

Provide a desktop header screenshot and select mode to run either rowDetection or rowMapping, then review the emitted JSON.

Frequently Asked Questions about desktop-navigation-agent

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

FAQPage Schema
How do I extract navigation rows from a desktop header screenshot?

Extract navigation rows from a desktop header screenshot by providing the image and selecting rowDetection mode to output a structured JSON payload representing the layout. This enables deterministic validation of desktop navigation structures without assumptions.

Can I use header screenshot analysis for mobile navigation layouts?

Header screenshot analysis does not support mobile navigation layouts. It is strictly designed for static desktop headers in web projects and should not be applied to mobile nav or non-header screenshots.

What JSON format does desktop header navigation analysis output?

Desktop header navigation analysis outputs strictly formatted JSON with explicit fields representing detected rows and alignment groups. It includes an uncertainty flag when the layout cannot be determined, ensuring reliable downstream automation.

Does the desktop navigation analyzer require an orchestrator to run?

The desktop navigation analyzer is invoked by excat-navigation-orchestrator to validate desktop navigation structures. While it functions as a component within that orchestration workflow, it requires a header screenshot and mode selection as direct inputs.

What are the limitations of analyzing header screenshots for navigation mapping?

Limitations of analyzing header screenshots include lack of support for mobile navigation and non-header screenshots, plus an uncertainty flag is emitted when the layout cannot be determined. It only processes static desktop headers containing logos, nav links, and locale selectors.