gh-aw

Compile markdown workflows into executable GitHub Actions YAML artifacts.

3|1|Updated Apr 12, 2026
One-click install
npx skills add https://github.com/Cogni-AI-OU/cogni-ai-agent-skills --skill gh-aw-cogni-ai-ou
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gh-aw
Source: https://github.com/Cogni-AI-OU/cogni-ai-agent-skills/tree/main/gh-aw
Command: npx skills add https://github.com/Cogni-AI-OU/cogni-ai-agent-skills --skill gh-aw-cogni-ai-ou

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It streamlines creating, compiling, running, and auditing GitHub Agentic Workflows so teams can reliably automate repository automation and workflow execution.

Core Features & Use Cases

  • Workflow authoring and compilation: Convert markdown workflow definitions into executable GitHub Actions YAML via compile, keeping agent workflow behavior consistent with source definitions.
  • Safe setup and execution: Initialize repositories, add or remove workflows, run workflows or trial runs, and manage required secrets and enable/disable states.
  • Operational auditing and troubleshooting: Audit workflow runs, analyze logs, classify CI check states, and diagnose failures by using the recommended troubleshooting skill.

Quick Start

Load the gh-aw skill and ask your agent to compile and run a specific Agentic Workflow for your repository to verify it behaves correctly.

Frequently Asked Questions about gh-aw

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

FAQPage Schema
How do I compile markdown workflow definitions into GitHub Actions YAML?

You compile markdown workflow definitions into executable GitHub Actions YAML artifacts by using the gh aw extension, ensuring agent workflow behavior remains consistent with the source definitions. This yields a .lock.yml file for execution.

How do I audit GitHub Actions workflow runs and analyze CI logs for failures?

You audit GitHub Actions workflow runs and analyze CI logs by using the gh aw extension to classify CI check states and diagnose failures. It provides workflow-specific log-based analysis to troubleshoot repository automation health.

Can I run a trial execution of an agentic workflow in my repository?

Yes, you can run a trial execution of an agentic workflow in your repository using the gh aw extension. It supports initializing infrastructure, managing required secrets, and performing trial runs to verify behavior before real execution.

What is the best way to manage GitHub Agentic Workflows end to end?

Managing GitHub Agentic Workflows end to end involves orchestrating workflow definitions, compilation, execution, and run analysis. The gh aw extension streamlines creating, compiling, running, and auditing these workflows to reliably automate repository tasks.

Why do I need to initialize agentic workflow infrastructure before running workflows?

You need to initialize agentic workflow infrastructure to establish the required repository setup, manage secrets, and enable or disable workflow states. This safe setup ensures that workflow execution and compilation function correctly within your environment.

Does the gh cli work with GitHub Agentic Workflows for repository automation?

Yes, the gh cli works with GitHub Agentic Workflows through the gh aw extension. It orchestrates repository automation tasks including workflow initialization, compilation into .lock.yml artifacts, execution, and operational auditing.