Hacktoberfest 2026: the issues maintainers tagged for October, open and beginner-friendly. Browse Hacktoberfest issues

[workshop-sync] workshop/06-install-gh-aw.md: inaccurate gh aw init output and stale version example

Closed Beginner friendly
  • Is something wrong?
#4,490 0 comments 0 reactions 0 assignees View on GitHub

Maintainers usually reply within 1 day

Nobody has claimed this yet.

Assessment

Difficulty
1/5
Estimated time
1-3 hours
Newbie friendliness
86/100
Issue type
Documentation
Clarity
Clearly specified
Activity status
Active
Tech stack
github, github-actions
Domain
documentation

Research direction

Open workshop/06-install-gh-aw.md and compare the listed files with the gh aw init --help behavior described in the issue. Update the file list to remove the nonexistent designer skill and revise the example version string. Done when both inaccuracies are corrected in the workshop text.

Written by the indexing model from the issue text.

Description

documentation

Workshop file reviewed

workshop/06-install-gh-aw.md

Problem 1 — nonexistent file claimed from gh aw init

The file states:

This creates several files needed for agentic workflow authoring:
.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.

The authoritative gh aw init --help output (gh-aw v0.89.21) describes the command as creating only:

  • .github/skills/agentic-workflows/SKILL.md (the dispatcher skill)
  • .vscode/settings.json
  • With --engine copilot: .github/agents/agentic-workflows.md
  • With --engine copilot (and not --no-mcp): .github/workflows/copilot-setup-steps.yml and .github/mcp.json

There is no mention of an agentic-workflow-designer skill being created by gh aw init anywhere in the CLI help. This repository's own .github/skills/ directory (populated by a prior gh aw init run) also contains no agentic-workflow-designer folder.

Current correct behaviour

Per gh aw init --help:

This command:
- Configures .gitattributes to mark .lock.yml files as generated
- Creates the dispatcher skill at .github/skills/agentic-workflows/SKILL.md
- Removes old prompt files from .github/prompts/ if they exist
- Configures VSCode settings (.vscode/settings.json)
...
With --engine copilot:
- Creates the custom agent at .github/agents/agentic-workflows.md

With --engine copilot (without --no-mcp):
- Creates .github/workflows/copilot-setup-steps.yml with gh-aw installation steps
- Creates .github/mcp.json with gh-aw MCP server configuration

Suggested fix

Remove the .github/skills/agentic-workflow-designer/SKILL.md entry from the bullet list of files created by gh aw init, keeping only the files actually documented by the CLI.

Problem 2 — stale example version string

The file says:

You should see output like gh-aw version 0.81.6.

The current gh-aw release is v0.89.21. The illustrative example version is far out of date and could confuse learners into thinking they are behind when they are actually current.

Suggested fix

Update the example output to a current-style version string, e.g. gh-aw version 0.89.21 (or a generic placeholder if the intent is just to show the output format).

Generated by 🔍 Workshop Sync Check · copilot · auto · 143.1 AIC · ⌖ 5 AIC · ⊞ 9.2K · ◷

  • expires on Oct 13, 2026, 5:05 AM UTC
Dominant language
JavaScript
Stars
53
Forks
35
Avg merge
12h 58m
Merged PRs (30d)
15

Getting set up

Open in Codespaces

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

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from githubnext/gh-aw-workshop

All issues in githubnext/gh-aw-workshop

Similar issues

More JavaScript issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.