Azure Devops

Azure DevOps Skill

Complete Azure DevOps integration covering boards, repositories, pipelines, and artifacts through the Azure CLI and the official azure-devops extension.

Auto-activates when: User mentions Azure DevOps, ADO, work items, boards, repos, pipelines, artifacts, or Azure DevOps URLs.

Quick Start

1. Authenticate and configure defaults

az extension add --name azure-devops
az login
export AZURE_DEVOPS_ORG_URL="${AZURE_DEVOPS_ORG_URL:?set the Azure DevOps organization URL}"
export AZURE_DEVOPS_PROJECT="${AZURE_DEVOPS_PROJECT:?set the Azure DevOps project name}"
az devops configure --defaults organization="$AZURE_DEVOPS_ORG_URL" project="$AZURE_DEVOPS_PROJECT"
az devops configure --list

See [@authentication.md] for setup details.

2. Common operations

Create a work item:

az boards work-item create \
  --type "User Story" \
  --title "Implement feature" \
  --description "<p>Story description</p>"

Query work items:

az boards query \
  --wiql "SELECT [System.Id], [System.Title] FROM workitems WHERE [System.AssignedTo] = @Me ORDER BY [System.ChangedDate] DESC"

Create a pull request:

az repos pr create \
  --source-branch feature/branch \
  --target-branch main \
  --title "Add feature"

Progressive Loading References

• [@authentication.md] - Azure CLI login and project defaults
• [@cli-automation.md] - CLI automation patterns, dashboards, az devops invoke, and JMESPath
• [@work-items.md] - Work item creation, updates, links, and queries
• [@queries.md] - WIQL query patterns
• [@html-formatting.md] - Formatting HTML descriptions for Azure DevOps
• [@repos.md] - Repository and pull request operations
• [@pipelines.md] - Pipeline and build operations
• [@artifacts.md] - Package feed operations

Important Notes

• Azure DevOps work item descriptions are HTML. Convert Markdown to HTML before passing long descriptions.
• Prefer --output json when automation needs IDs or URLs.
• Always configure organization and project defaults before running board/repo commands.
• Use az devops invoke only when the official az boards, az repos, az pipelines, or az artifacts command group does not expose the needed operation.