azure-devops-cli

Manage Azure DevOps projects, pipelines, pull requests, and work items via the Azure CLI.

Updated Sep 10, 2026
One-click install
npx skills add https://github.com/serpro-workshop-fortaleza/sifap-modernization-paula --skill azure-devops-cli-serpro-workshop-fortaleza
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: azure-devops-cli
Source: https://github.com/serpro-workshop-fortaleza/sifap-modernization-paula/tree/main/.github/skills/azure-devops-cli
Command: npx skills add https://github.com/serpro-workshop-fortaleza/sifap-modernization-paula --skill azure-devops-cli-serpro-workshop-fortaleza

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Teams that must operate an existing Azure DevOps organization need a scriptable way to manage repositories, pull requests, pipelines, builds, work items, and security without clicking through the web portal, while avoiding common pitfalls like PAT leakage and Windows command-line length limits. ## Core Features & Use Cases - Full CLI coverage: Command references for az devops, az pipelines, az boards, az repos, and az artifacts, including JMESPath queries and output formatting. - Automation patterns: Idempotent scripts for creating pipelines, variable groups, service connections, and bulk work-item updates, plus retry and error-handling patterns. - Windows long-comment workaround: Documented solutions for the 8,191-character cmd.exe limit when posting long PR descriptions or work-item discussions. - Use Case: A developer needs to create a pull request, queue a CI pipeline run, and link work items entirely from the terminal; the skill provides the exact command sequence with verification of returned IDs. ## Quick Start Ask the assistant to create a pull request in your Azure DevOps repository from the current branch to main and queue the CI pipeline using the Azure CLI.

Frequently Asked Questions about azure-devops-cli

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

FAQPage Schema
How do I create a pull request in Azure DevOps from the command line?

Use az repos pr create with --repository, --source-branch, --target-branch, --title, and --description. You can also attach work items, assign reviewers, mark it as draft, and enable auto-complete with az repos pr update --auto-complete true.

How do I authenticate the Azure CLI with Azure DevOps?

Provide a Personal Access Token through the AZURE_DEVOPS_EXT_PAT environment variable, then run az devops login with your organization URL. Set defaults with az devops configure so you do not repeat --org and --project on every command.

Why does my long PR description or work item comment fail on Windows?

On Windows, az resolves to az.cmd, which is limited to about 8,191 characters by cmd.exe, silently truncating long arguments. Use azps.ps1 in PowerShell, a native --file-path option where available, or az devops invoke with --in-file.

How do I run an Azure Pipeline and wait for it to finish in a script?

Queue the run with az pipelines run and capture the run ID using --query id -o tsv. Then poll az pipelines runs show in a loop until the status is no longer inProgress or notStarted, and check the result field.

Can I query Azure DevOps work items with WIQL from the CLI?

Yes, az boards query accepts a --wiql parameter with a WIQL statement such as selecting work items assigned to you in a given state. Combine it with --output table or JMESPath queries to format results for scripts.

When should I not use this Azure DevOps CLI skill?

Do not use it to migrate a GitHub-based workflow to Azure DevOps; the kit's source of truth for code, issues, and CI is GitHub. Use it only when a team must operate an existing Azure DevOps organization.