skills.rest
github
githubOFFICIAL
Explore all skills by this author →
WebsiteGitHub

debugging-workflows

Diagnose GitHub Agentic Workflow failures by collating logs and auditing runs.

4.9k|489|Updated Aug 12, 2025
Search Tags:#workflow#debugging#troubleshooting#logs#audit#GitHub#agentic-workflows
One-click install
npx skills add https://github.com/github/gh-aw --skill debugging-workflows-github
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: debugging-workflows
Source: https://github.com/github/gh-aw/tree/main/.github/skills/debugging-workflows
Command: npx skills add https://github.com/github/gh-aw --skill debugging-workflows-github

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps engineering teams quickly diagnose failures in GitHub Agentic Workflows by consolidating logs, auditing runs, and guiding troubleshooting efforts.

Core Features & Use Cases

  • Diagnose failures by analyzing workflow logs and run histories.
  • Audit specific workflow runs to surface errors, misconfigurations, and tool usage patterns.
  • Reproduce issues and validate fixes using guided debugging commands and references.
  • Use Case: A maintainer sees a failing agentic workflow; this Skill provides step-by-step commands to download logs, audit the run, and identify the root cause.

Quick Start

Use the debugging skill to inspect recent runs and gather artifacts:

  • gh aw logs --start-date -1d -o /tmp/workflow-logs
  • gh aw audit 1234567890
  • gh aw logs weekly-research --start-date -1d
  • gh aw audit https://github.com/owner/repo/actions/runs/1234567890

Frequently Asked Questions about debugging-workflows

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

FAQPage Schema
How do I debug failing GitHub Agentic Workflows using run logs?▼

Debug failing GitHub Agentic Workflows by pulling run logs with commands like `gh aw logs` to consolidate histories and surface errors for quick root cause analysis.

How do I audit a specific GitHub Actions run to diagnose agent failures?▼

Audit a specific GitHub Actions run by executing `gh aw audit <run-id>` to surface errors, misconfigurations, and tool usage patterns within the agent's execution.

What is the best way to retrieve workflow logs for troubleshooting agent behavior?▼

Retrieve workflow logs for troubleshooting agent behavior by running `gh aw logs` with a target workflow name and start date to download artifacts for offline inspection.

Can I audit a GitHub workflow run directly using its URL?▼

Yes, you can audit a GitHub workflow run directly by passing its full URL to the `gh aw audit` command to quickly reproduce issues and validate fixes.

What does an agentic workflow audit report include when diagnosing failures?▼

An agentic workflow audit report includes run histories, misconfigurations, tool usage patterns, and safety-conscious debugging guidance within a controlled workflow context.

Related Skills

Explore More Software Engineering Skills→
kaushal-waygoodkaushal-waygood

debugging-workflows

Diagnose GitHub Agentic Workflow issues by analyzing logs and auditing runs.

Community
Advanced
randoneeringrandoneering

semantic-view-optimization-time-tracking

Tracks and reports execution time for semantic optimization workflows via console summaries and CSV/JSON exports.

Community
Advanced
serac-labsserac-labs
77

event-management

Automate ServiceNow Event Management artifacts and correlation workflows.

Official
Intermediate
benzwickbenzwick

download-ci-artifacts

Download GitHub Actions CI artifacts using gh CLI commands.

Community
Intermediate