Ado PowerShell — DevOps skill for Claude Code

ado-powershell

An AI agent skill that enables GitHub Copilot, Claude Code, and other compatible agents to interact with the **Azure DevOps REST API** using PowerShell - covering Work Items, Test Plans, Pipelines, Git repositories, and more.

---

Installation

Install the CLI globally from npm:

npm install -g ado-powershell

Then, inside any project where you want the skill available to your AI agent:

cd your-project
adops install --skills

This copies the skill files into `.github/skills/ado-powershell/` in your project. GitHub Copilot and Claude Code will discover and use them automatically.

---

Requirements

• Node.js 16+ (for the CLI)
• PowerShell 7+ or Windows PowerShell 5.1 (for the skill scripts)
• An Azure DevOps Personal Access Token (PAT) with permissions matching the operations you need

---

Configuration

Set these environment variables before the agent runs the skill:

$env:ADO_ORG     = 'my-organization'
$env:ADO_PROJECT = 'my-project'
$env:ADO_PAT     = 'your-pat-here'   # never hardcode; read from a secret store

Alternatively, pass values explicitly to `Initialize-AdoSession`, or point it to a JSON config file. See the skill's [SKILL.md](.github/skills/ado-powershell/SKILL.md) for the full resolution order.

---

What the skill provides

Once installed, the agent gets access to the following PowerShell functions:

Domain	Functions
Work Items	Get, batch-get, WIQL query, create, update, comment, link, attach files
Testing	Test Plans, Suites, Cases, Runs, Results (read and write)
Pipelines	List pipelines, list and filter runs, trigger a run
Git	Repositories, branches, team iterations/sprints

All write functions support `-WhatIf` for dry-run simulation. Full parameter documentation and examples are in the [references](.github/skills/ado-powershell/references/) folder.

---

Skill structure

.github/skills/ado