# Pipelines Build Summary

> List, inspect, and troubleshoot Azure DevOps pipeline builds. Shows recent builds for a pipeline definition, drills into a specific build's status and result, displays logs for failed steps, and lists the changes associated with a build.

- **Type:** Skill
- **Install:** `agentstack add skill-microsoft-azure-devops-skills-pipelines-build-summary`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [microsoft](https://agentstack.voostack.com/s/microsoft)
- **Installs:** 0
- **Category:** [Cloud & Infrastructure](https://agentstack.voostack.com/c/cloud-infrastructure)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [microsoft](https://github.com/microsoft)
- **Source:** https://github.com/microsoft/azure-devops-skills/tree/main/.github/skills/pipelines-build-summary

## Install

```sh
agentstack add skill-microsoft-azure-devops-skills-pipelines-build-summary
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Pipeline build summary

This skill works in the context of a **project**. A **pipeline definition** or **build ID** is optional and depends on what the user asks.

## Project selection

- If the user **provides a project name** in their request (for example, "for Contoso"), use that project directly and **do not call** `core_list_projects`.
- If the user **does not provide a project name**, first ask the user once to provide the project name.
- If the project name is **still not provided after asking once**, call `core_list_projects` to return a list of projects the user can choose from.

## Pipeline definition selection

- If the user **provides a pipeline or definition name**, use `pipelines_get_build_definitions` with a `name` filter to find it.
- If the user **does not specify a pipeline** and the request requires one (for example, "show recent builds"), ask the user once for the pipeline name.
- If the pipeline name is **still not provided after asking once**, call `pipelines_get_build_definitions` to list available definitions for the user to choose from.

# Tools

Use Azure DevOps MCP Server tools for all interactions with Azure DevOps.

- `core_list_projects`: Get a list of projects in the organization.
- `pipelines_get_build_definitions`: Get a list of build/pipeline definitions for a project.
- `pipelines_get_builds`: Get a list of builds, optionally filtered by definition, branch, or status.
- `pipelines_get_build_status`: Get the status and result of a specific build by ID.
- `pipelines_get_build_log`: Get the list of logs for a specific build.
- `pipelines_get_build_log_by_id`: Get a specific log by log ID for a build (use to retrieve failed step logs).
- `pipelines_get_build_changes`: Get the commits/changes associated with a specific build.

# Rules

## 1. List recent builds for a pipeline

- When the user asks to **list builds** or **show recent builds** for a pipeline, call `pipelines_get_builds` filtered by the definition ID.
- Optionally filter by `branchName`, `statusFilter`, or `resultFilter` if the user specifies (for example, "failed builds on main").
- Do **not** fetch logs or changes unless the user asks.
- Show the results in a table.
- If there are no builds, explicitly state that there are no builds for this pipeline.

### Example

- "show recent builds for pipeline 'CI-Main' in project Contoso"

## 2. Get build status by ID

- When the user asks about a **specific build** (for example, "build 12345"), call `pipelines_get_build_status` with that build ID.
- Show the build number, status, result, source branch, start/finish time, requested by, and definition name.
- If the build failed, suggest viewing the logs.

### Example

- "what is the status of build 12345 in project Contoso?"

## 3. View logs for a failed build

- When the user asks to **view logs** or **why a build failed**, first call `pipelines_get_build_log` to get the list of all log entries for the build.
- Identify failed steps from the log list (look for steps that indicate errors or failures).
- Call `pipelines_get_build_log_by_id` for the relevant failed log entries to retrieve the actual log content.
- Present the log output in a code block so it is easy to read.
- Do **not** dump all logs. Focus on the failed steps and the last portion of each relevant log.

### Example

- "show me the logs for build 12345 in project Contoso"
- "why did build 12345 fail?"

## 4. List changes for a build

- When the user asks to **see what changed** or **list commits** for a build, call `pipelines_get_build_changes` with the build ID.
- Show the results in a table with commit ID, author, and message.
- If there are no changes, explicitly state that there are no changes associated with this build.

### Example

- "what changes were in build 12345?"
- "list commits for build 12345 in project Contoso"

# Display results

When displaying build lists, show the following in a table:

- **Build ID** as a clickable hyperlink in this format: `[{buildId}](https://dev.azure.com/{organization}/{project}/_build/results?buildId={buildId})`
- **Definition name**
- **Status** (for example: completed, inProgress, cancelling, notStarted)
- **Result** (for example: succeeded, failed, canceled, partiallySucceeded) — use emoji: ✅ succeeded, ❌ failed, ⚠️ partiallySucceeded, 🚫 canceled
- **Source branch**
- **Start time** formatted as `MM/DD/YYYY HH:MM`
- **Requested by** (display name only)

When displaying a single build's status, show all the above fields plus:
- **Finish time** formatted as `MM/DD/YYYY HH:MM`
- **Build number**
- **Duration** (calculated from start and finish time)

When displaying changes, show in a table:
- **Commit ID** (short hash, first 8 characters)
- **Author**
- **Message** (first line only)
- **Timestamp**

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [microsoft](https://github.com/microsoft)
- **Source:** [microsoft/azure-devops-skills](https://github.com/microsoft/azure-devops-skills)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-microsoft-azure-devops-skills-pipelines-build-summary
- Seller: https://agentstack.voostack.com/s/microsoft
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.