- The first Quick setup guide steps do not include setting up the aw skill which is crucial for easing authoring over the portal. I think it should be front-loaded so even casual users with attention span issues get it from the first page.
- The additional instructions for Quick setup suggest "gh aw init" will create a skill. This did not work for me. Smells like a bug/doc bug.
https://github.github.com/gh-aw/setup/creating-workflows/
Initialize the Repository
Running gh aw init is required to enable the authoring experience in the GitHub code agent. This step configures your repository so that you can create and modify agentic workflows directly from github.com or the GitHub mobile app, using the Copilot coding agent.
Terminal window
gh aw init
Alternatively, run this prompt in your coding agent:
Initialize this repository for GitHub Agentic Workflows using https://raw.githubusercontent.com/github/gh-aw/main/install.md
This command:
Creates a dispatcher skill at .github/skills/agentic-workflows/SKILL.md, which registers the agentic-workflows skill in GitHub Copilot and enables workflow authoring with the agentic-workflows skill in Copilot Chat on github.com and the GitHub mobile app.
My repo:
D:\bench>gh aw init
🚀 Welcome to GitHub Agentic Workflows!
This tool will initialize your repository for GitHub Agentic Workflows.
ℹ Setting up repository...
✓ Repository initialized for agentic workflows!
ℹ To create a workflow, see https://github.github.com/gh-aw/setup/creating-workflows
ℹ Or add an example workflow, see https://github.com/githubnext/agentics
D:\bench>dir .github
Volume in drive D is Dev
Volume Serial Number is B81A-1D7F
Directory of D:\bench.github
05/29/2026 10:46 AM
.
05/29/2026 10:46 AM ..
05/29/2026 10:41 AM agents
11/25/2025 07:06 PM 6,974 copilot-instructions.md
05/29/2026 10:46 AM 147 mcp.json
05/29/2026 10:46 AM workflows
2 File(s) 7,121 bytes
4 Dir(s) 22,517,829,632 bytes free
D:\bench>
https://github.github.com/gh-aw/setup/creating-workflows/
Initialize the Repository
Running gh aw init is required to enable the authoring experience in the GitHub code agent. This step configures your repository so that you can create and modify agentic workflows directly from github.com or the GitHub mobile app, using the Copilot coding agent.
Terminal window
gh aw init
Alternatively, run this prompt in your coding agent:
Initialize this repository for GitHub Agentic Workflows using https://raw.githubusercontent.com/github/gh-aw/main/install.md
This command:
Creates a dispatcher skill at .github/skills/agentic-workflows/SKILL.md, which registers the agentic-workflows skill in GitHub Copilot and enables workflow authoring with the agentic-workflows skill in Copilot Chat on github.com and the GitHub mobile app.
My repo:
D:\bench>gh aw init
🚀 Welcome to GitHub Agentic Workflows!
This tool will initialize your repository for GitHub Agentic Workflows.
ℹ Setting up repository...
✓ Repository initialized for agentic workflows!
ℹ To create a workflow, see https://github.github.com/gh-aw/setup/creating-workflows
ℹ Or add an example workflow, see https://github.com/githubnext/agentics
D:\bench>dir .github
Volume in drive D is Dev
Volume Serial Number is B81A-1D7F
Directory of D:\bench.github
05/29/2026 10:46 AM
.05/29/2026 10:46 AM ..
05/29/2026 10:41 AM agents
11/25/2025 07:06 PM 6,974 copilot-instructions.md
05/29/2026 10:46 AM 147 mcp.json
05/29/2026 10:46 AM workflows
2 File(s) 7,121 bytes
4 Dir(s) 22,517,829,632 bytes free
D:\bench>