
boards-work-item-summary
β Officialβ 24by microsoft Β· part of microsoft/azure-devops-skills
Summarize a single Azure DevOps work item (and its links and comments) by ID.
This is the playbook your agent receives when the skill activates β you don't need to read it to use the skill, but it's here to audit before installing.
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_work_item(action:get): Get a work item from Azure DevOps by its ID.wit_work_item(action:list_comments): Get the list of comments for a work item by its ID.wit_work_item(action:get_batch): Get work item details in batch by their IDs. Use this tool to get the details of linked work items, using the links returned fromwit_work_itemwith actionget.
Steps
-
Call
wit_work_itemwith actiongetandexpand=allfor the requested ID so that you retrieve fields, relations, and links in a single call. -
If the work item has a parent (for example,
System.Parentor aSystem.LinkTypes.Hierarchy-Reverserelation), include the parent ID in the set of linked IDs to summarize. You do not need a separate call; instead, rely onwit_work_itemwith actionget_batchin the next step. -
From the work item
relationsarray, collect all linked work item IDs (parent, child, related, and any others). Callwit_work_itemwith actionget_batchonce with that list of IDs to get the details of all linked work items. -
Call
wit_work_itemwith actionlist_commentsonce 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.
- Id as a clickable hyperlink in this exact format:
-
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.
npx skills add microsoft/azure-devops-skills --skill "boards-work-item-summary" --full-depthRun this in your project β your agent picks the skill up automatically.
No common issues documented yet. If you hit a problem, the repository's GitHub Issues page is the best place to look.
Licensed under MITβ you can use, modify, and redistribute it under that license's terms.
View the full license file on GitHub β