Skip to content
Skills Library
DevOps & cloud · Analysis

debug-workflow

/debug-workflow

Diagnose a failing ado-aw agentic Azure DevOps pipeline. Use when the user reports a pipeline failing, an agent unable to reach an MCP/network host, safe outputs not being applied, or wants to understand why a build behaved a certain way.

Repository
ado-aw ↗
Licence
MIT
Last repository change
27.10.2026

Assessment and security

86/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content21 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
1
Scripts
0
HTML comments
1
URLs in SKILL.md
1
Deprecation

No signals detected. Repository changed on 27.10.2026, without references to retired models or APIs.

Licence

MIT, open: use and modify while retaining author attribution.

What to check before installing
  • SKILL.md zawiera komentarze HTML (1). Nie widać ich w podglądzie Markdown, a model je czyta.

What it does and when to use it

Diagnose a failing ado-aw agentic Azure DevOps pipeline. Use when the user reports a pipeline failing, an agent unable to reach an MCP/network host, safe outputs not being applied, or wants to understand why a build behaved a certain way.

Original author description

Diagnose a failing ado-aw agentic Azure DevOps pipeline. Use when the user reports a pipeline failing, an agent unable to reach an MCP/network host, safe outputs not being applied, or wants to understand why a build behaved a certain way.

How it works

SKILL.md has no level-two headings · 29 lines, 151 words

SKILL.md preview
---
name: debug-workflow
description: Diagnose a failing ado-aw agentic Azure DevOps pipeline. Use when the user reports a pipeline failing, an agent unable to reach an MCP/network host, safe outputs not being applied, or wants to understand why a build behaved a certain way.
allowed-tools: Bash, Read, Write, Edit, Glob, Grep, mcp__ado-aw__trace_failure, mcp__ado-aw__audit_build, mcp__ado-aw__whatif, mcp__ado-aw__inspect_workflow, mcp__ado-aw__graph_summary, mcp__ado-aw__lint_workflow
---

# Debug an ado-aw workflow

You are troubleshooting a **failing** ado-aw agentic workflow.

1. Confirm the `ado-aw` compiler is installed (`ado-aw --version`).

2. Gather evidence before theorizing:
   - `trace_failure` — trace the build's failed-job chain using audit data plus
     the local IR graph (pass the build id or full ADO build URL).
   - `audit_build` — download and analyze the build's artifacts (firewall/network
     logs, MCP tool calls, safe-output NDJSON, detection findings, policy signals).
   - `whatif` — classify which downstream jobs are skipped when a given step/job
     fails, to confirm the blast radius.

3. Load the **entire** content of the authoritative, version-pinned playbook and
   follow its instructions precisely:

   https://raw.githubusercontent.com/githubnext/ado-aw/v0.54.0/prompts/debug-ado-agentic-workflow.md <!-- x-release-please-version -->

4. For Stage 3 (SafeOutputs) 401/403 failures, consult
   `docs/safe-output-permissions.md` and surface the auth/permission error
   verbatim with the doc pointer.

5. If a fix requires a source change, validate it with `ado-aw compile` +
   `lint_workflow` before proposing it.

The user's request: $ARGUMENTS

Versions

RepositoryScoreLicence
This page · githubnext/ado-aw86MIT
synaptiai/agent-capability-standard100Apache-2.0

Database snapshot: 13.11.2026 · package version 64f25a1248bb (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 86compile-and-validate
    Compile an ado-aw agent file to Azure DevOps pipeline YAML and validate it. Use when the user asks to compile a workflow, check whether it is valid, verify a pipeline matches its source, or understand the compiled IR / dependency graph.
  • 100azure-devops-workflow
    Use Azure DevOps Services to triage Azure Boards work items or sprint backlogs, inspect and review Azure Repos pull requests, or diagnose Azure Pipelines builds and runs. Also use when the user supplies a dev.azure.com link for one of those resources.
  • 100azure-devops
    Set up Azure Pipelines for CI/CD, configure build and release pipelines, manage Azure DevOps projects, and integrate with Azure services. Use when working with Azure DevOps Services or Server for enterprise DevOps workflows.
  • 100azure-devops-pipelines
    Best practices for Azure DevOps Pipeline YAML files Triggers on: **/azure-pipelines.yml, **/azure-pipelines*.yml, **/*.pipeline.yml
  • 90manage-lifecycle
    Operate compiled ado-aw pipelines in Azure DevOps. Use when the user wants to register/enable/disable/remove build definitions, queue runs, set pipeline secrets, or report pipeline status.
  • 90azure-devops
    Use when user references Azure DevOps / ADO, dev.azure.com or an on-prem TFS URL, work items, bugs, PBIs, pull requests, or the project wiki. Goes through the azure-devops MCP server.

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.