debugging-workflows

Analyze GitHub Agentic Workflow logs and audit runs to surface errors.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/maxfraieho/garden-seedling --skill debugging-workflows-maxfraieho
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: debugging-workflows
Source: https://github.com/maxfraieho/garden-seedling/tree/main/gh-aw/.github/skills/debugging-workflows
Command: npx skills add https://github.com/maxfraieho/garden-seedling --skill debugging-workflows-maxfraieho

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Troubleshooting GitHub Agentic Workflows by analyzing logs, auditing runs, and diagnosing issues to restore reliable automation.

Core Features & Use Cases

  • Download and inspect workflow logs to pinpoint failures.
  • Audit individual workflow runs to surface errors, tool usage, and misconfigurations.
  • Review agent behavior, safe-outputs, and MCP configurations to fix bottlenecks.
  • Use advanced debugging techniques to monitor status and collect metrics.

Quick Start

Install the GitHub Agentic Workflows extension, then run a sample audit of a recent workflow to begin debugging.

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?

To debug GitHub Agentic Workflows, you can download and inspect workflow logs to pinpoint failures. The tool audits individual runs to surface errors, tool usage, and misconfigurations, restoring reliable automation.

What is the best way to audit a GitHub workflow run for agent misconfigurations?

The best way to audit a GitHub workflow run is by using gh aw commands to examine agent behavior, safe-outputs, and MCP configurations. This process surfaces errors and fixes performance bottlenecks across repositories.

How do I retrieve and analyze logs to troubleshoot GitHub Actions automation issues?

You can retrieve and analyze workflow logs to troubleshoot GitHub Actions automation issues by running an audit of recent workflow runs. This allows you to examine tool usage and permissions to diagnose errors.

Do I need the GitHub Agentic Workflows extension to audit agent behavior and safe-outputs?

Yes, you need to install the GitHub Agentic Workflows extension to audit agent behavior and safe-outputs. Once installed, you can run sample audits and use gh aw commands to generate structured JSON reports.

Why is my GitHub Agentic Workflow failing despite correct permissions?

Your GitHub Agentic Workflow might be failing due to misconfigurations in MCP setups or safe-outputs. Auditing individual runs and examining tool usage across repositories with guardrails helps surface these hidden errors.

Can I generate structured JSON reports when auditing GitHub workflow runs?

Yes, you can generate structured JSON reports when auditing GitHub workflow runs. The debugging process supports JSON outputs and structured reports with guardrails to guide safe and reliable automation troubleshooting.