Claude-skill-registry df:az-cli

This skill should be used when working with Azure DevOps from the command line. Trigger when user mentions az devops, az repos, az pipelines, az boards, or asks about managing PRs, work items, pipelines, or repositories in Azure DevOps. Also trigger for questions about Azure DevOps CLI setup, authentication, or querying work items.

install
source · Clone the upstream repo
git clone https://github.com/majiayu000/claude-skill-registry
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/majiayu000/claude-skill-registry "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/data/az-cli" ~/.claude/skills/majiayu000-claude-skill-registry-df-az-cli && rm -rf "$T"
manifest: skills/data/az-cli/SKILL.md
source content

Azure DevOps CLI

Overview

Manage Azure DevOps resources using the

az
CLI with the
azure-devops
extension. Covers repositories, pull requests, pipelines, boards, and work items.

Prerequisites

# Install azure-devops extension (requires az cli 2.30+)
az extension add --name azure-devops

# Authenticate
az login

# Set defaults (recommended)
az devops configure --defaults organization=https://dev.azure.com/YOUR_ORG project=YOUR_PROJECT

Most-Used Commands

My Pull Requests

# List PRs I created
az repos pr list --creator "$(az account show --query user.name -o tsv)"

# List PRs assigned to me for review
az repos pr list --reviewer "$(az account show --query user.name -o tsv)"

# Show PR details
az repos pr show --id <pr-id>

# Checkout PR locally
az repos pr checkout --id <pr-id>

My Work Items

# List work items assigned to me
az boards query --wiql "SELECT [System.Id], [System.Title], [System.State] FROM WorkItems WHERE [System.AssignedTo] = @Me AND [System.State] <> 'Closed' ORDER BY [System.ChangedDate] DESC"

# Show work item details
az boards work-item show --id <work-item-id>

# Create work item
az boards work-item create --title "Task title" --type "Task"

# Update work item state
az boards work-item update --id <id> --state "In Progress"

Pipelines

# List pipelines
az pipelines list

# List recent runs
az pipelines runs list --top 10

# Run a pipeline
az pipelines run --name "pipeline-name"

# Run with parameters
az pipelines run --name "pipeline-name" --parameters "env=prod version=1.0"

# Show run details
az pipelines runs show --id <run-id>

Repositories

# List repositories
az repos list

# Show repo details
az repos show --repository <repo-name>

# Create repository
az repos create --name "new-repo"

Pull Request Workflow

# Create PR
az repos pr create --source-branch feature/my-branch --target-branch main --title "PR Title" --description "Description"

# Add reviewers
az repos pr update --id <pr-id> --reviewers user@email.com

# Set vote (approve: 10, approve with suggestions: 5, wait: -5, reject: -10)
az repos pr set-vote --id <pr-id> --vote 10

# Complete/merge PR
az repos pr update --id <pr-id> --status completed

References

Detailed command references available:

  • references/repos.md
    - Repository management, PRs, policies, refs
  • references/pipelines.md
    - Pipeline CRUD, runs, variables, releases
  • references/boards.md
    - Work items, queries, areas, iterations
  • references/devops.md
    - Organization, projects, teams, wikis, auth

Common Flags

Most commands support:

FlagDescription
--org
Organization URL (or set via
az devops configure
)
--project
Project name (or set via
az devops configure
)
--detect
Auto-detect org/project from git remote
-o json/table/tsv
Output format

Troubleshooting

# Check current config
az devops configure --list

# Verify authentication
az account show

# Check extension version
az extension show --name azure-devops