home / skills / ntaksh42 / agents / azure-dashboard-creator

azure-dashboard-creator skill

safe

This skill helps you create Azure DevOps dashboards with widgets and metrics to visualize team progress and project health.

npx playbooks add skill ntaksh42/agents --skill azure-dashboard-creator

Review the files below or copy the command above to add this skill to your agents.

Files (1)

SKILL.md

1.3 KB

---
name: azure-dashboard-creator
description: Create Azure DevOps dashboards with widgets and metrics. Use when visualizing project metrics or creating team dashboards.
---

# Azure Dashboard Creator Skill

Azure DevOpsダッシュボードを作成するスキルです。

## 主な機能

- **ウィジェット配置**: チャート、グラフ
- **クエリベース**: WIQLクエリ結果表示
- **ビルド状況**: パイプライン状態
- **チームメトリクス**: ベロシティ、バーンダウン

## ダッシュボード作成（REST API）

```json
{
  "name": "Team Dashboard",
  "widgets": [
    {
      "name": "Build Status",
      "position": {
        "row": 1,
        "column": 1
      },
      "size": {
        "rowSpan": 1,
        "columnSpan": 2
      },
      "settings": {
        "buildDefinitionId": "123"
      },
      "contributionId": "ms.vss-build-web.build-definition-widget"
    },
    {
      "name": "Active Bugs",
      "position": {
        "row": 2,
        "column": 1
      },
      "size": {
        "rowSpan": 2,
        "columnSpan": 2
      },
      "settings": {
        "queryId": "456"
      },
      "contributionId": "ms.vss-dashboards-web.Microsoft.VisualStudioOnline.Dashboards.QueryResultsWidget"
    }
  ]
}
```

## バージョン情報
- Version: 1.0.0

Overview

This skill creates Azure DevOps dashboards populated with widgets and metrics for project and team visibility. It assembles widgets such as build status, query results, charts, and team metrics into reusable dashboard definitions. Use it to programmatically generate or update dashboards via the Azure DevOps REST API. Versioned and focused on practical dashboard composition.

How this skill works

The skill builds JSON dashboard definitions that specify widget types, positions, sizes, settings, and contribution IDs accepted by Azure DevOps. It supports query-based widgets (WIQL results), pipeline/build status widgets, and team metric widgets like velocity and burndown. Output is ready to send to the Azure DevOps Dashboards REST endpoints to create or update dashboards. Widgets are placed using row/column coordinates and span values for layout control.

When to use it

Create consistent team dashboards programmatically across projects or organizations
Automate dashboard provisioning during project setup or onboarding
Visualize WIQL query results and active work item metrics in a shared view
Monitor pipeline and build health across teams
Standardize KPI dashboards for program or portfolio reporting

Best practices

Define a reusable widget template with contributionId and minimal required settings
Use query IDs instead of embedding WIQL when queries are managed in Azure DevOps
Plan grid positions and spans to avoid overlapping widgets and ensure responsive layout
Version dashboard JSON and apply changes through CI/CD to keep dashboards reproducible
Limit widget refresh frequency for performance and avoid excessive API calls

Example use cases

Generate a new Team Dashboard including build status and active bugs when a new team is created
Deploy a standard program dashboard across multiple projects to track velocity and burndown
Automate nightly updates to dashboards showing latest pipeline statuses and test pass rates
Create a management view that aggregates key queries (active defects, blocked work, deployment health)

FAQ

What widget types are supported?

Widgets supported include build/pipeline status, query results, charts, and team metric widgets referenced by contributionId. Use the contributionId for specific widget behavior.

How do I deploy the JSON to Azure DevOps?

Send the dashboard JSON to the Azure DevOps Dashboards REST API (create or update endpoints). Ensure the calling identity has dashboard write permissions.