debugging-workflows

$npx mdskill add github/gh-aw/debugging-workflows

This skill remains available for existing invocations. Load and follow [the evidence reference](../../aw/debug-workflow-evidence.md), where the instructions now live. It delegates setup to [the bootstrap](../../aw/debug-bootstrap.md) and execution policy to [the shared strategy](../../aw/debug-agentic-workflow.md).

SKILL.md

.github/skills/debugging-workflowsView on GitHub ↗
---
name: debugging-workflows
description: Diagnose gh-aw failures using the canonical debugging strategy and evidence reference.
---

# Workflow Debugging Router

This skill remains available for existing invocations. Load and follow
[the evidence reference](../../aw/debug-workflow-evidence.md), where the
instructions now live. It delegates setup to
[the bootstrap](../../aw/debug-bootstrap.md) and execution policy to
[the shared strategy](../../aw/debug-agentic-workflow.md).

Use a matching local guidance checkout. For Contents API reads, use the guidance
owner/repository (`owner=github`, `repo=gh-aw` by default),
`path=.github/aw/debug-workflow-evidence.md`, retaining the ref of this skill.
The other API paths are `.github/aw/debug-bootstrap.md` and
`.github/aw/debug-agentic-workflow.md`. Normalize relative links against their
containing file before API reads; `../../aw/...` is not an API path.
For default raw guidance, use `https://raw.githubusercontent.com/github/gh-aw/<guidance-ref>/`
plus the repository-root-relative path, including `.github/`. Preserve supplied
refs containing slashes and keep guidance identity separate from the target
workflow repository/ref. The bootstrap documents size-aware reads and public
raw fallback after API denial.

Read the canonical instructions before running commands. This compatibility
router defines no separate setup, review, or live-execution procedure.

More from github/gh-aw

SkillDescription
agentic-workflow-designerConversational skill that interviews users to design new agentic workflows
aw-valueDesign and verify a deterministic operational-value grader for a GitHub Agentic Workflow. Use for per-run operational value, evidence attribution, maturation, baselines, and operational-value evaluators. Usage: /aw-value OWNER/REPO WORKFLOW-NAME.
awf-release-integratorUpgrade gh-aw to latest gh-aw-firewall release and identify follow-up spec tasks.
checkout-credential-reviewReview code that performs git or gh operations against repository checkouts in gh-aw, checking that the right credentials are available at the right time and that sparseness, shallowness and credential-free factors are properly considered.
console-renderingUse Go struct tags to render styled terminal output in gh-aw.
copilot-reviewTeach Copilot how to plan, address, and respond to pull request review feedback.
create-canvasAuthor, validate, and debug canvas extensions that the agent can open in the GitHub Copilot app's side panel. Use when creating, reviewing, or troubleshooting a canvas extension — including its actions, inputs, rendered content, and the surrounding extension wiring (tools, hooks, lifecycle).
custom-agentsDefine and validate GitHub custom agent files, prompts, and examples.
custom-engine-implementationAdd and test declarative behavior-defined agentic engines in gh-aw, extending Go infrastructure only when necessary.
developerCore developer rules and coding conventions for gh-aw changes.