tsuga-build-dashboard

Build Tsuga dashboards with validated widget JSON payloads.

2|Updated May 28, 2026
One-click install
npx skills add https://github.com/tsuga-dev/agent-plugins --skill tsuga-build-dashboard
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: tsuga-build-dashboard
Source: https://github.com/tsuga-dev/agent-plugins/tree/main/plugins/tsuga/skills/tsuga-build-dashboard
Command: npx skills add https://github.com/tsuga-dev/agent-plugins --skill tsuga-build-dashboard

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

It helps you build and maintain correct Tsuga dashboards by discovering real metric names, verifying aggregation queries, and assembling a valid dashboard payload with proper layout and guardrails.

Core Features & Use Cases

  • Dashboard widget construction workflow: Converts metric discovery results into widget-specific query bodies, including widget schema, formulas, and layout placement.
  • Verified metric/aggregation queries: Ensures every metric and aggregation body is validated using tsuga-cli before embedding it into the dashboard.
  • Safe create/update operations: Prevents unintended dashboard mutations by requiring explicit user confirmation and by fetching the existing dashboard before updates.

Quick Start

Ask the assistant to create a Tsuga dashboard for service X with owner team ID Y and a specified dashboard time window.

Frequently Asked Questions about tsuga-build-dashboard

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

FAQPage Schema
How do I create a Tsuga dashboard with validated metric queries?

To create a Tsuga dashboard, provide your service name, owner team ID, and desired time window. The system discovers real metric names and verifies aggregation queries using tsuga-cli before assembling the validated widget JSON payload.

What is the safest way to update an existing monitoring layout in Tsuga?

The safest way to update a Tsuga monitoring layout is by fetching the existing dashboard first and requiring explicit user confirmation before performing mutations. This prevents unintended changes to widget schemas and layout placement.

How does widget automation handle metric discovery and query validation?

Widget automation handles metric discovery by converting the results into widget-specific query bodies, including formulas and layout placement. It ensures every metric and aggregation body is verified via tsuga-cli before embedding it into the dashboard.

Do I need a team ID to build observability dashboards for my services?

Yes, you need a team ID to build observability dashboards. The system enforces dashboard ownership via team IDs to ensure safe create and update operations across health, throughput, and latency views.

Can I fix incorrect aggregation choices in my Tsuga dashboard layout?

Yes, you can fix incorrect aggregation choices across health, throughput, and latency views. The system corrects metric and aggregation choices by validating queries with tsuga-cli and assembling a valid dashboard payload with proper layout guardrails.