Skip to content

[workshop-sync] side-quest-06-04-install-local.md: gh aw init file list and stale version example are inaccurate #3089

Closed

Description

@github-actions

Workshop file reviewed

workshop/side-quest-06-04-install-local.md

Problem 1: incorrect file list for 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 live gh aw init --help snapshot (v0.88.2) describes this command's actual behavior:

  • Configures .gitattributes
  • Creates the dispatcher skill at .github/skills/agentic-workflows/SKILL.md
  • Removes old prompt files from .github/prompts/ if present
  • Configures .vscode/settings.json
  • Generates .github/workflows/agentics-maintenance.yml (conditionally, if any workflow uses expires)
  • With --engine copilot: creates .github/agents/agentic-workflows.md
  • With --engine copilot (and not --no-mcp): creates .github/workflows/copilot-setup-steps.yml and .github/mcp.json

There is no mention of .github/skills/agentic-workflow-designer/SKILL.md anywhere in the current CLI help. This file appears to no longer be created (or was never created) by gh aw init.

Current correct syntax/behavior

Per gh aw init --help (v0.88.2), the generated files are conditional on flags (e.g. --engine copilot), and the file list should not include agentic-workflow-designer/SKILL.md.

Suggested fix

Update the file list to match the current gh aw init --help output, and note that some files (agent, MCP config, setup-steps workflow) are only created --engine copilot. Remove .github/skills/agentic-workflow-designer/SKILL.md unless it can be confirmed as still generated by another mechanism.

Problem 2: stale example version string

"You should see output like gh-aw version 0.81.6."

The current gh-aw release is v0.88.2 (published 2026-09-03). While this is just an example format, it's noticeably behind the current release and could confuse learners about whether their install is current.

Suggested fix

Update the example to a version closer to the current release (e.g. gh-aw version 0.88.2) or phrase it generically as gh-aw version X.Y.Z.

Generated by 🔍 Workshop Sync Check · copilot · auto · 76.2 AIC · ⌖ 10.2 AIC · ⊞ 9.6K · ◷

  • expires on Sep 9, 2026, 4:44 PM UTC
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Labels

documentationImprovements or additions to documentation

Type

No type

Projects

No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions