gh-aw
New4.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
- Workflow compilation: edit workflow markdown, then recompile lock files
- Engine selection: set
enginein frontmatter to control runtime agent behavior - MCP tools: configure GitHub/MCP toolsets in frontmatter for repository operations
- 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 24814681146Where to learn more in this repo
- •
/AGENTS.mdfor development/agent workflow conventions - •
/skills/*/SKILL.mdfor focused domain guidance (GitHub MCP, docs, errors, etc.)
Install & Usage
1
Create the skills directory
mkdir -p .claude/skills2
Download the skill file
mkdir -p .claude/skills && curl -o .claude/skills/gh-aw.md https://raw.githubusercontent.com/github/gh-aw/main/SKILL.md3
Invoke in Claude Code
/gh-awView 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.