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/datacorp-sifap-modernization-team-kit --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/datacorp-sifap-modernization-team-kit/tree/main/.github/skills/azure-devops-cli
Command: npx skills add https://github.com/serpro-workshop-fortaleza/datacorp-sifap-modernization-team-kit --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 often waste time clicking through the web portal for repetitive tasks like creating pull requests, queueing pipelines, or updating work items in bulk. This Skill provides complete, verified CLI command references so those operations can be scripted and automated from the terminal. ## Core Features & Use Cases - Full CLI coverage: Command syntax and examples for az devops, az pipelines, az boards, az repos, and az artifacts, organized by domain into eight reference files. - Automation patterns: Idempotent scripts, retry logic, error handling, JMESPath queries, and real-world workflows such as CI/CD setup and bulk work-item updates. - Windows long-argument workaround: Documented solutions for the 8,191-character cmd.exe limit that truncates long --description or --discussion values. - Use Case: A developer needs to create a pull request, queue a CI pipeline, and link work items without opening the browser. The Skill supplies the exact authenticated command sequence and verifies the returned PR and run IDs. ## Quick Start Ask the AI to create a pull request in your Azure DevOps repository and queue the CI pipeline using the az CLI with your configured organization and project.

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 the azure-devops CLI extension, specifying `--repository`, `--source-branch`, `--target-branch`, `--title`, and `--description`. Add `--reviewers`, `--work-items`, or `--draft true` as needed, and use `--output table` to verify the returned PR ID.

How to authenticate az devops CLI with a personal access token?▼

Set the PAT in the `AZURE_DEVOPS_EXT_PAT` environment variable, then run `az devops login --organization https://dev.azure.com/{org}`. Configure defaults with `az devops configure --defaults organization=... project=...` to avoid repeating flags. Never hardcode the PAT in scripts.

Why does my long PR description fail on Windows with az CLI?▼

On Windows, `az` resolves to `az.cmd`, which is limited to about 8,191 characters by cmd.exe, silently truncating long `--description` or `--discussion` values. Use `azps.ps1` in PowerShell, a native `--file-path` option, or `az devops invoke --in-file` instead.

Can I update Azure DevOps work items in bulk with a script?▼

Yes. Query item IDs with `az boards query --wiql`, then loop over the results calling `az boards work-item update --id $id --state "Active"`. Use `--output tsv` for clean scriptable output and add retry logic for transient network failures.

When should I not use the Azure DevOps CLI skill?▼

Do not use it to migrate a GitHub-based workflow to Azure DevOps; it applies only when a team must operate an existing Azure DevOps organization. For GitHub-centric work, use GitHub Issues, Pull Requests, Actions, and Projects instead.

How do I filter az pipelines output with JMESPath?▼

Pass a JMESPath expression via `--query`, for example `az pipelines list --query "[?name=='myPipeline']"` or `az pipelines runs list --query "[?status=='completed' && result=='succeeded']"`. Combine with `--output table` or `tsv` for readable or scriptable results.