Skip to content

installing the aw skill #35762

@NikolajBjorner

Description

@NikolajBjorner
  1. 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.
  2. 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>

Metadata

Metadata

Assignees

No one assigned

    Type

    No type
    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions