skills.rest
coolrobertj
coolrobertjCOMMUNITY
Explore all skills by this author →
GitHub

ado

Query and update Azure DevOps work items via WIQL and REST scripts.

1|Updated May 13, 2026
Search Tags:#query#rest api#azure devops#work items#ado#wiql#assign
One-click install
npx skills add https://github.com/coolrobertj/Agency-Cowork --skill ado-coolrobertj
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: ado
Source: https://github.com/coolrobertj/Agency-Cowork/tree/main/skills/ado/skills/ado
Command: npx skills add https://github.com/coolrobertj/Agency-Cowork --skill ado-coolrobertj

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve? Managing Azure DevOps work items manually through the web UI is slow and repetitive, especially when you need to search across projects, run saved queries, or perform bulk updates like assignments and state changes. ## Core Features & Use Cases - Flexible Querying: Get work items by ID, run keyword searches across titles/descriptions/tags, execute arbitrary WIQL, run saved queries, or list items filtered by state, type, DRI, iteration, area, or tag. - Write Operations: Create work items, assign DRIs, update descriptions, add comments, set arbitrary fields, reparent items, and add links — all with mandatory user confirmation before execution. - Use Case: Ask your agent to "find all active bugs assigned to Jane in Sprint 5" and it runs the appropriate WIQL query, returning results as a table, JSON, or Markdown report. ## Quick Start Ask your agent to search ADO for all active bugs in your project and list them in a table.

Frequently Asked Questions about ado

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I search Azure DevOps work items by keyword?▼

Run ado_query with the search action and pass keywords that match against work item titles, descriptions, and tags. All provided keywords must match for a work item to appear in results.

How do I run a WIQL query against Azure DevOps from the command line?▼

Use ado_query with the wiql action and pass your full WIQL statement, such as selecting work items where state is Active and type is Bug. You can also execute saved queries by GUID using the saved-query action.

What authentication does Azure DevOps REST API access require?▼

Authentication uses the Azure CLI command az account get-access-token with the Azure DevOps resource ID 499b84ac-1321-427f-aa17-267ca6975798. You must be logged in via az login before running queries.

Can I create or update work items without confirmation prompts?▼

No. All write operations in ado_update, including create, assign, set-field, reparent, and add-link, require explicit user confirmation before executing. This confirmation step cannot be bypassed.

When should I use the landing-zone skill instead of general ADO queries?▼

Use the landing-zone skill for Landing Zone-specific tasks such as LZ sync, grading, WoW comparison, and state machine operations. The general ADO skill covers standard work item querying and updates only.

Related Skills

Explore More Software Engineering Skills→
j-mckerracherj-mckerracher

azure-devops-cli

Manage Azure DevOps resources via az devops CLI commands.

Community
Advanced
Emz1998Emz1998
1

reporting-sprints

Generate sprint reports with goals, completed work, blockers, and velocity.

Community
Basic
Golnaz89Golnaz89

distributed-mesh

Generate mesh.json and copy sync scripts for git-backed cross-machine squads.

Community
Intermediate
jaimedhenriquesjaimedhenriques

azure-devops-cli

Manage Azure DevOps resources via Azure CLI commands.

Community
Intermediate