understand-dashboard

Launch a Vite dashboard to visualize a project's knowledge graph.

Updated Jun 28, 2026
One-click install
npx skills add https://github.com/AO-HyS/aohys.com --skill understand-dashboard-ao-hys
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: understand-dashboard
Source: https://github.com/AO-HyS/aohys.com/tree/main/.agents/skills/understand-dashboard
Command: npx skills add https://github.com/AO-HyS/aohys.com --skill understand-dashboard-ao-hys

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? After generating a knowledge graph of a codebase, developers need an interactive way to explore it rather than reading raw JSON. This Skill starts a local web dashboard that renders the graph visually. ## Core Features & Use Cases - Dashboard Launch: Locates the dashboard package across multiple install roots, installs dependencies, builds the core package, and starts a Vite dev server in the background. - Token-Secured Access: Captures the tokenized URL printed by the server so the user can pass the access gate without digging through terminal output. - Use Case: After running the understand analysis on a repository, launch the dashboard to browse the knowledge graph of modules and relationships in a browser at a local address. ## Quick Start Ask the assistant to launch the understand dashboard for the current project so you can explore its knowledge graph in the browser.

Frequently Asked Questions about understand-dashboard

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

FAQPage Schema
How do I visualize a codebase knowledge graph in a browser?▼

Run the understand-dashboard skill after generating a knowledge graph. It starts a Vite dev server pointed at the project's .understand-anything/knowledge-graph.json and prints a tokenized local URL to open in your browser.

What do I need before launching the understand dashboard?▼

You need a knowledge graph generated first by running the understand analysis on the project. If .understand-anything/knowledge-graph.json is missing, the skill tells you to run /understand before launching the dashboard.

Why does the dashboard show an Access Token Required gate?▼

The dashboard requires a token query parameter to read knowledge graph data. The Vite server prints a URL containing ?token=<TOKEN>; you must open that full URL, since omitting the token triggers the access gate.

What happens if port 5173 is already in use?▼

Vite automatically selects the next available port when 5173 is taken. The skill captures the actual port from the server output and reports the correct tokenized URL to the user.

Can I point the dashboard at a different project directory?▼

Yes. Pass a project path as the skill argument and the dashboard uses that directory's knowledge graph. Without an argument, it defaults to the current working directory via the GRAPH_DIR environment variable.