gh-aw-troubleshooting
OfficialRoot-cause gh-aw workflow failures fast
Software Engineering#github#agentic workflows#workflow debugging#safe-outputs#mcp troubleshooting#firewall egress#tool missing
AuthorCogni-AI-OU
Version1.0.0
Installs0
System Documentation
What problem does it solve?
It diagnoses and resolves failing GitHub Agentic Workflows (gh-aw) by turning run failures into actionable root-cause analysis across tools, permissions, MCP configuration, firewall egress, and safe-outputs behavior.
Core Features & Use Cases
- Run-Centric Root-Cause Debugging: Extracts a run ID, audits the run artifacts, and correlates missing tools and failures with the workflow configuration.
- Configuration Verification: Checks MCP server/toolset settings and validates safe-outputs and permissions so fixes address the actual gating constraints.
- Log-Driven Evidence: Guides inspection of agent stdio logs and generated reports to pinpoint issues like 401s, missing tools, MCP timeouts, blocked domains, or rejected writes.
Quick Start
Use gh-aw-troubleshooting to diagnose a failing workflow run by running the audit for the specific run ID and following the reported missing tools, firewall findings, and safe-outputs or MCP mismatch signals.
Dependency Matrix
Required Modules
None requiredComponents
Standard package💻 Claude Code Installation
Recommended: Let Claude install automatically. Simply copy and paste the text below to Claude Code.
Please help me install this Skill: Name: gh-aw-troubleshooting Download link: https://github.com/Cogni-AI-OU/cogni-ai-agent-skills/archive/main.zip#gh-aw-troubleshooting Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
Agent Skills Search Helper
Install a tiny helper to your Agent, search and equip skill from 471,000+ vetted skills library on demand.