azure-devops

Manages Azure DevOps work items and pull requests through the az CLI.

Updated Aug 26, 2026
One-click install
npx skills add https://github.com/ulebule/claude-skills --skill azure-devops-ulebule
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: azure-devops
Source: https://github.com/ulebule/claude-skills/tree/main/plugins/azure-devops/skills/azure-devops
Command: npx skills add https://github.com/ulebule/claude-skills --skill azure-devops-ulebule

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Working with Azure DevOps from the command line is error-prone: the REST API redirects unauthenticated requests, the gh CLI targets GitHub instead, and org/project values are often hardcoded. This Skill provides a tested set of az CLI patterns for reading, creating, linking, and querying work items and pull requests, with org and project derived automatically from the git remote. ## Core Features & Use Cases - Work item operations: Read, create, update, and link work items via az boards, including WIQL queries and correct handling of Bug Repro Steps as HTML. - Pull request workflows: Create PRs linked to work items, check PR status, and avoid pitfalls like completed PRs deleting remote branches or autocomplete transitioning work items unexpectedly. - Portable project context: Derives organization and project from the git remote or az devops defaults, so it works on any Azure DevOps project without hardcoding. - Use Case: You need to file a bug under an existing user story. The Skill finds the parent US via WIQL, creates the Bug with matching area/iteration, writes Repro Steps, links the parent, and creates a PR tied to the work item. ## Quick Start Ask the assistant to read work item #1234 or create a bug linked to a user story in your Azure DevOps project using the az CLI.

Frequently Asked Questions about azure-devops

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

FAQPage Schema
How do I create an Azure DevOps work item from the command line?

Use az boards work-item create with the azure-devops CLI extension, specifying type, title, area, and iteration. Take area and iteration values from a related parent item when the user does not specify them, and return the new ID with a JSON query.

How do I run a WIQL query with the az CLI?

Run az boards query with a --wiql parameter containing your SELECT statement. Always use -o json output, because table output drops fields, and extract values from the fields object in the JSON response.

Why does the Azure DevOps REST API return a 302 redirect?

Unauthenticated REST API calls via curl or WebFetch redirect to a login page, making it look like you lack access. Use the az CLI with the azure-devops extension instead, which is already authenticated through az login or a PAT.

Can I link a pull request to a work item in Azure DevOps?

Yes, pass --work-items with the work item ID when running az repos pr create. Avoid enabling autocomplete unless requested, and set transitionWorkItems to false so linked items do not jump to Resolved automatically.

Why does az boards work-item create fail with an unknown identity error?

The assignee email may differ from the local git config because the DevOps identity uses another domain. Check an existing work item's AssignedTo uniqueName field to find the correct identity value.