# Boards Work Item Summary

> Summarize a single Azure DevOps work item (and its links and comments) by ID. Use when this capability is needed.

- Skill: `tomevault-io/boards-work-item-summary` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/boards-work-item-summary`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/boards-work-item-summary/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: DevOps & Infra
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/boards-work-item-summary

---


# Get work item

This skill always works with **one specific work item ID**.

- If the user **provides an ID** (for example: "for 115770" or "work item 115770"), use that ID directly.
- If the user **does not provide an ID**, prompt the user once to provide the work item ID.
- If the ID is **still not provided after prompting**, stop and return a clear message stating that a work item ID is required and do not call any tools.

# Tools

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

- `wit_get_work_item`: Get a work item from Azure DevOps by its ID.
- `wit_list_work_item_comments`: Get the list of comments for a work item by its ID.
- `wit_get_work_items_batch_by_ids`: Get work item details in batch by their IDs. Use this tool to get the details of linked work items, using the links returned from `wit_get_work_item`.

# Steps

1. Call `wit_get_work_item` with `expand=all` for the requested ID so that you retrieve fields, relations, and links in a single call.

2. If the work item has a parent (for example, `System.Parent` or a `System.LinkTypes.Hierarchy-Reverse` relation), include the parent ID in the set of linked IDs to summarize. You do **not** need a separate `wit_get_work_item` call for the parent; instead, rely on `wit_get_work_items_batch_by_ids` in the next step.

3. From the work item `relations` array, collect all linked work item IDs (parent, child, related, and any others). Call `wit_get_work_items_batch_by_ids` once with that list of IDs to get the details of all linked work items.

4. Call `wit_list_work_item_comments` once to get the comments for the original work item.

# Display results

When displaying the results:

- Show the following fields for the main work item: **Id**, **Title**, **State**, **Assigned To** (just the display name, not the email), **Work Item Type**, **Created Date** formatted as `MM/DD/YYYY`, **Priority**, and **Tags**.

- Provide a **Links** table. For each linked work item, display:
	- **Id** as a clickable hyperlink in this exact format: `[{ID}](https://dev.azure.com/{organization}/{project}/_workitems/edit/{ID})`
	- **Link type** (for example: Parent, Child, Related, or the underlying relation name)
	- **Work item type**
	- **Title**
	- **State**

	Group and order the rows in this sequence: **Parent links first**, then **Child links**, then **Related links**, then any **other link types**.

- If there are pull requests linked to the work item (for example, via artifact links or specific PR relations), list them in a separate **Pull Requests** table with at least the PR ID, title, status, and a clickable link to the PR.

- Provide a short, plain-language **summary** of the work item’s description, system information, and repro steps (if those fields exist). Focus on the key intent, scope, and any critical technical or repro details.

- For **comments**:
	- If there are one or more comments, state the **total number of comments** and give a brief overview of the main themes or decisions mentioned.
	- If there are **no comments**, explicitly state that there are no comments for this work item.

---
> Converted and distributed by [TomeVault](https://tomevault.io/claim/microsoft) — claim your Tome and manage your conversions.
<!-- tomevault:4.0:skill_md:2026-04-13 -->