BeClaude

gh-aw

New
4.6kGitHubGeneralby github

GitHub Agentic Workflows

Community PluginView Source

Overview

gh-aw Prompt Surface

This repository builds gh-aw (GitHub Agentic Workflows), a GitHub CLI extension for writing workflows in markdown and compiling them to GitHub Actions.

What this surface does

  • Converts markdown workflow specs (.md) into compiled lock files (.lock.yml)
  • Supports multiple AI engines (copilot, claude, codex, custom)
  • Integrates tools, including GitHub MCP servers and safe-output tooling
  • Provides CLI commands to compile, run, inspect, and audit workflows

Key concepts

  1. Workflow compilation: edit workflow markdown, then recompile lock files
  2. Engine selection: set engine in frontmatter to control runtime agent behavior
  3. MCP tools: configure GitHub/MCP toolsets in frontmatter for repository operations
  4. Safe outputs: workflow-safe issue/comment output paths and constraints

Representative usage examples

bash
# Compile markdown workflows to lock files
gh aw compile

# Run a workflow manually
gh aw run .github/workflows/daily-skill-optimizer.md

# Inspect MCP server usage in workflows
gh aw mcp list
gh aw mcp inspect daily-skill-optimizer

# Audit a workflow run
gh aw audit 24814681146

Where to learn more in this repo

  • /AGENTS.md for development/agent workflow conventions
  • /skills/*/SKILL.md for focused domain guidance (GitHub MCP, docs, errors, etc.)

Install & Usage

1
Create the skills directory
mkdir -p .claude/skills
2
Download the skill file
mkdir -p .claude/skills && curl -o .claude/skills/gh-aw.md https://raw.githubusercontent.com/github/gh-aw/main/SKILL.md
3
Invoke in Claude Code
/gh-aw
View source on GitHub
agent

Frequently Asked Questions

What is gh-aw?

GitHub Agentic Workflows

How to install gh-aw?

To install gh-aw, create the .claude/skills directory in your project, then run the curl command to download the skill file. Once installed, invoke it in Claude Code with /gh-aw.

What is gh-aw best for?

gh-aw is a community categorized under General. It is designed for: agent. Created by github.