[workshop-sync] workshop/06-install-gh-aw.md: `gh aw init` file list doesn't match CLI help
Maintainers usually reply within 1 day
Nobody has claimed this yet.
Assessment
- Difficulty
- 1/5
- Estimated time
- Under an hour
- Newbie friendliness
- 86/100
- Issue type
- Documentation
- Clarity
- Clearly specified
- Activity status
- Active
- Tech stack
- github
- Domain
- documentation
Research direction
Read workshop/06-install-gh-aw.md and compare its lines 72–76 with the gh aw init --help snapshot at /tmp/gh-aw/data/gh-aw-cli-help.json. Remove the listed skill that plain init does not create, and clarify whether the agent, setup workflow, and MCP file require --engine copilot. Done when the workshop accurately describes the files created by the documented command.
Written by the indexing model from the issue text.
Description
Workshop file reviewed
workshop/06-install-gh-aw.md (gh-aw release v0.92.0)
Problem
Lines 72-76 say gh aw init creates:
.github/skills/agentic-workflows/SKILL.md,.github/skills/agentic-workflow-designer/SKILL.md,.github/agents/agentic-workflows.md,.github/mcp.json,.github/workflows/copilot-setup-steps.yml, and.vscode/settings.json.
Current behaviour
The live gh aw init --help says plain gh aw init creates only the dispatcher skill .github/skills/agentic-workflows/SKILL.md, and configures .gitattributes and .vscode/settings.json. It does not list an agentic-workflow-designer skill. The custom agent file, copilot-setup-steps.yml and .github/mcp.json come from the --engine copilot section of the help, and mcp.json is skipped with --no-mcp.
Suggested fix
- Remove the
agentic-workflow-designer/SKILL.mdentry. - Either change the command to
gh aw init --engine copilot, or state that the agent,copilot-setup-steps.ymlandmcp.jsonfiles are only created with--engine copilot.
Source: gh aw init --help snapshot (/tmp/gh-aw/data/gh-aw-cli-help.json).
Generated by 🔍 Workshop Sync Check · copilot · auto · 49.5 AIC · ⌖ 0.548 AIC · ⊞ 9.3K · ◷
- expires on Oct 19, 2026, 3:33 PM UTC
- Dominant language
- JavaScript
- Stars
- 53
- Forks
- 35
- Avg merge
- 1d 6h
- Merged PRs (30d)
- 15
Getting set up
Starts the project's dev container in your browser, under your own GitHub account.
- No Dockerfile or Docker Compose file
- No pull request template
- No contributing guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
More from githubnext/gh-aw-workshop
-
broken-image
Difficulty 2/5 1-3 hours Newbie friendliness 65/100
githubnext/gh-aw-workshop#4787 ·
Maintainers usually reply within 1 day
-
curriculum documentation quality
Difficulty 2/5 1-3 hours Newbie friendliness 78/100
githubnext/gh-aw-workshop#4786 ·
Maintainers usually reply within 1 day
-
[curriculum-eval] side-quest-17-07-repo-poisoning.md: cognitive_load — 23 new concepts in 1234 wordsOpencurriculum documentation quality
Difficulty 2/5 1-3 hours Newbie friendliness 74/100
githubnext/gh-aw-workshop#4784 ·
Maintainers usually reply within 1 day
-
[curriculum-eval] 04-github-actions-intro.md: cognitive_load — 28 new concepts in an intro pageOpencurriculum documentation quality
Difficulty 2/5 1-3 hours Newbie friendliness 78/100
githubnext/gh-aw-workshop#4785 ·
Maintainers usually reply within 1 day
-
curriculum documentation quality
Difficulty 2/5 1-3 hours Newbie friendliness 68/100
githubnext/gh-aw-workshop#4782 ·
Maintainers usually reply within 1 day
All issues in githubnext/gh-aw-workshop
Similar issues
-
Difficulty 2/5 1-3 hours Newbie friendliness 82/100
Maintainers usually reply within 2 days
-
bug
Difficulty 2/5 1-3 hours Newbie friendliness 78/100
swc-project/swc-next#1022 ·
Maintainers usually reply within 1 day
-
area-clientside-dartpad
Difficulty 2/5 1-3 hours Newbie friendliness 66/100
Maintainers usually reply within 2 days
-
Difficulty 2/5 1-3 hours Newbie friendliness 65/100
alphagov/public-asset-checker#378 · 1 comment ·
Maintainers usually reply within 1 day
-
headers-parser: `forRegExp` does not escape regexp characters in path segments that contain `*`Possibly taken @RaphaelFakhri claimed this today. Open
Difficulty 2/5 1-3 hours Newbie friendliness 85/100
Maintainers usually reply within 1 day