azure-devops_skill

Overview

This skill provides full Azure DevOps management via REST API using OAuth device flow or Personal Access Token authentication. It exposes scripts to manage projects, work items, repos, pull requests, pipelines, wikis, test plans, security alerts, variable groups, environments/approvals, branch policies, and attachments. Designed for automation and interactive agent workflows across 13 domains with extensive tooling.

How this skill works

The skill calls Azure DevOps REST API v7.1 through a collection of Python scripts. Authentication is supported with OAuth device code flow (recommended) or PAT; tokens auto-refresh for OAuth. Each script targets a domain (work items, repos, pipelines, etc.) and accepts clear command-line parameters for listing, creating, updating, running, and approving resources.

When to use it

• Create or update work items, iterations, and backlogs.
• Manage Git repos: branches, commits, and pull requests including reviewers and comments.
• Run, monitor, and inspect pipeline builds, logs, artifacts, and stages.
• Manage wikis, test plans, and test results.
• Query or act on security alerts and configure branch policies.
• Manage variable groups, environment approvals, and deployment checks.

Best practices

• Prefer OAuth device flow for automated token refresh and least privilege.
• Use specific project and repo flags to scope commands and avoid cross-project side effects.
• Pass --top or pagination parameters when listing to control response sizes.
• Use descriptive titles and fields when creating work items or PRs to ease traceability.
• Treat secrets in variable groups as secret flags and limit access scope.
• Validate pipeline runs and approval actions with get/list commands before approving or canceling.

Example use cases

• Create a sprint iteration and assign it to a team with start/finish dates.
• Create a bug work item, assign it, add comments, and link it to a parent story.
• Create a feature branch, push changes, and open a pull request with reviewers and comments.
• Queue a pipeline run with variables for environment and monitor logs until completion.
• List and triage security alerts for a repository, then view alert details.
• Create or update a wiki page with deployment or runbook content.