github/awesome-copilot / skills/azure-devops-cli
azure-devops-cli
FlaggedManage Azure DevOps resources via CLI including projects, repos, pipelines, builds, pull requests, work items, artifacts, and service endpoints. Use when working with Azure DevOps, az commands, devops automation, CI/CD, or when user mentions Azure DevOps CLI.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 4.2 KB |
| references/advanced-usage.md | markdown | 5.3 KB |
| references/boards-and-iterations.md | markdown | 6.0 KB |
| references/long-comments-on-windows.md | markdown | 3.1 KB |
| references/org-and-security.md | markdown | 9.0 KB |
| references/pipelines-and-builds.md | markdown | 4.7 KB |
| references/repos-and-prs.md | markdown | 6.6 KB |
| references/variables-and-agents.md | markdown | 3.7 KB |
| references/workflows-and-patterns.md | markdown | 16.0 KB |
references/boards-and-iterations.md
View on GitHub# Work Items, Area Paths & Iterations
## Table of Contents
- [Work Items (Boards)](#work-items-boards)
- [Area Paths](#area-paths)
- [Iterations](#iterations)
---
## Work Items (Boards)
### Query Work Items
```bash
# WIQL query
az boards query \
--wiql "SELECT [System.Id], [System.Title], [System.State] FROM WorkItems WHERE [System.AssignedTo] = @Me AND [System.State] = 'Active'"
# Query with output format
az boards query --wiql "SELECT * FROM WorkItems" --output table
```
### Show Work Item
```bash
az boards work-item show --id {work-item-id}
az boards work-item show --id {work-item-id} --open
```
### Create Work Item
```bash
# Basic work item
az boards work-item create \
--title "Fix login bug" \
--type Bug \
--assigned-to user@example.com \
--description "Users cannot login with SSO"
# With area and iteration
az boards work-item create \
--title "New feature" \
--type "User Story" \
--area "Project\\Area1" \
--iteration "Project\\Sprint 1"
# With custom fields
az boards work-item create \
--title "Task" \
--type Task \
--fields "Priority=1" "Severity=2"
# With discussion comment
az boards work-item create \
--title "Issue" \
--type Bug \
--discussion "Initial investigation completed"
# For a long --discussion body on Windows, see references/long-comments-on-windows.md.
# Short version: use azps.ps1 in PowerShell, or fall back to 'az devops invoke'
# with --in-file when no native --file-path flag is available.
# Open in browser after creation
az boards work-item create --title "Bug" --type Bug --open
```
### Update Work Item
```bash
# Update state, title, and assignee
az boards work-item update \
--id {work-item-id} \
--state "Active" \
--title "Updated title" \
--assigned-to user@example.com
# Move to different area
az boards work-item update \
--id {work-item-id} \
--area "{ProjectName}\\{Team}\\{Area}"
# Change iteration
az boards work-item update \
--id {work-item-id} \
--iteration "{ProjectName}\\Sprint 5"
# Add comment/discussion
az boards work-item update \
--id {work-item-id} \
--discussion "Work in progress"
# Long comment on Windows: read the body into a PowerShell variable and call
# azps.ps1 instead of az.cmd, or fall back to 'az devops invoke' with --in-file.
# Full guidance in references/long-comments-on-windows.md.
#
# PowerShell example:
# $body = Get-Content -Raw .\comment.md
# azps.ps1 boards work-item update --id 1234 --discussion $body
# Update with custom fields
az boards work-item update \
--id {work-item-id} \
--fields "Priority=1" "StoryPoints=5"
```
### Delete Work Item
```bash
# Soft delete (can be restored)
az boards work-item delete --id {work-item-id} --yes
# Permanent delete
az boards work-item delete --id {work-item-id} --destroy --yes
```
### Work Item Relations
```bash
# List relations
az boards work-item relation show --id {work-item-id}
# List supported relation types
az boards work-item relation list-type
# Add relation
az boards work-item relation add --id {work-item-id} --relation-type parent --target-id {parent-id}
# Remove relation
az boards work-item relation remove --id {work-item-id} --relation-id {relation-id}
```
## Area Paths
### List Areas for Project
```bash
az boards area project list --project {project}
az boards area project show --path "Project\\Area1" --project {project}
```
### Create Area
```bash
az boards area project create --path "Project\\NewArea" --project {project}
```
### Update Area
```bash
az boards area project update \
--path "Project\\OldArea" \
--new-path "Project\\UpdatedArea" \
--project {project}
```
### Delete Area
```bash
az boards area project delete --path "Project\\AreaToDelete" --project {project} --yes
```
### Area Team Management
```bash
# List areas for team
az boards area team list --team {team-name} --project {project}
# Add area to team
az boards area team add \
--team {team-name} \
--path "Project\\NewArea" \
--project {project}
# Remove area from team
az boards area team remove \
--team {team-name} \
--path "Project\\AreaToRemove" \
--project {project}
# Update team area
az boards area team update \
--team {team-name} \
--path "Project\\Area" \
--project {project} \
--include-sub-areas true
```
## Iterations
### List Iterations for Project
```bash
az boards iteration project list --project {project}
az boards iteration project show --path "Project\\Sprint 1" --project {project}
```
### Create Iteration
```bash
az boards iteration project create --path "Project\\Sprint 1" --project {project}
```
### Update Iteration
```bash
az boards iteration project update \
--path "Project\\OldSprint" \
--new-path "Project\\NewSprint" \
--project {project}
```
### Delete Iteration
```bash
az boards iteration project delete --path "Project\\OldSprint" --project {project} --yes
```
### Team Iterations
```bash
# List iterations for team
az boards iteration team list --team {team-name} --project {project}
# Add iteration to team
az boards iteration team add \
--team {team-name} \
--path "Project\\Sprint 1" \
--project {project}
# Remove iteration from team
az boards iteration team remove \
--team {team-name} \
--path "Project\\Sprint 1" \
--project {project}
# List work items in iteration
az boards iteration team list-work-items \
--team {team-name} \
--path "Project\\Sprint 1" \
--project {project}
```
### Default & Backlog Iterations
```bash
# Set default iteration for team
az boards iteration team set-default-iteration \
--team {team-name} \
--path "Project\\Sprint 1" \
--project {project}
# Show default iteration
az boards iteration team show-default-iteration \
--team {team-name} \
--project {project}
# Set backlog iteration for team
az boards iteration team set-backlog-iteration \
--team {team-name} \
--path "Project\\Sprint 1" \
--project {project}
# Show backlog iteration
az boards iteration team show-backlog-iteration \
--team {team-name} \
--project {project}
# Show current iteration
az boards iteration team show --team {team-name} --project {project} --timeframe current
```
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| writing-skillsobra/superpowersUse when creating new skills, editing existing skills, or verifying skills work before deployment | Stars: 319k | Updated | Claude CodeCodex | Verified | Install |
| xlsxanthropics/skillsUse this skill any time a spreadsheet file is the primary input or output. This means any task where the user wants to: open, read, edit, or fix an existing .xlsx, .xlsm, .xltx, .csv, or .tsv file (e.g., adding columns, computing formulas, formatting, charting, cleaning messy data); create a new spreadsheet from scratch or from other data sources; or convert between tabular file formats. Trigger especially when the user references a spreadsheet file by name or path — even casually (like "the xlsx in my downloads") — and wants something done to it or produced from it. Also trigger for cleaning or restructuring messy tabular data files (malformed rows, misplaced headers, junk data) into proper spreadsheets. The deliverable must be a spreadsheet file. Do NOT trigger when the primary deliverable is a Word document, HTML report, standalone Python script, database pipeline, or Google Sheets API integration, even if tabular data is involved. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |
| shipping-and-launchaddyosmani/agent-skillsPrepares production launches. Use when preparing to deploy to production, or when asking what needs to be in place before shipping. Use when you need a pre-launch checklist, when setting up monitoring, when planning a staged rollout, or when you need a rollback strategy. | Stars: 118k | Updated | Claude CodeCodex | Verified | Install |
| childhoodthedotmack/claude-memBabysit a shipped release after merge, publication, or deployment. Verify published packages, production behavior, installed plugins, and late CI or user reports until the observation window is clean; use babysit for PR readiness before release. | Stars: 118k | Updated | Claude CodeCodex | Verified | Install |