Skip to content

[workshop-sync] workshop/06-install-gh-aw.md: stale version example and unconfirmed agentic-workflow-designer skill file #3143

Description

@github-actions

Workshop file reviewed

workshop/06-install-gh-aw.md

Problem 1: Stale version example

The install section says:

You should see output like gh-aw version 0.81.6.

The current gh-aw release is v0.88.7 (checked via gh api repos/github/gh-aw/releases/latest). Hardcoding an old version number in the expected output will confuse learners whose install shows a much newer version and may make them think something went wrong.

Suggested fix 1

Replace the hardcoded version with version-agnostic wording, e.g.:

You should see output confirming the installed version, such as gh-aw version X.Y.Z.

Problem 2: Unconfirmed second skill file created by gh aw init

The file states that 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.

The live gh aw init --help text (captured from the installed gh-aw v0.88.7 CLI) describes creating only:

  • .gitattributes updates
  • the dispatcher skill at .github/skills/agentic-workflows/SKILL.md
  • .vscode/settings.json
  • with --engine copilot: .github/agents/agentic-workflows.md, .github/workflows/copilot-setup-steps.yml, .github/mcp.json

There is no mention of a second .github/skills/agentic-workflow-designer/SKILL.md file in the live CLI help output or in the bundled reference docs (mcp-clis.md, syntax-core.md, syntax-agentic.md, github-agentic-workflows.md).

Suggested fix 2

Confirm whether gh aw init actually creates a second agentic-workflow-designer skill file in the current release. If it does not, remove that line from the generated-files list. If it does (e.g. introduced in a version not reflected in the --help summary), please note the doc source that confirms it so the workshop text is verifiable.

Warning

Firewall blocked 1 domain

The following domain was blocked by the firewall during workflow execution:

  • githubnext.github.io

To allow these domains, add them to the network.allowed list in your workflow frontmatter:

network:
  allowed:
    - defaults
    - "githubnext.github.io"

See Network Configuration for more information.

Generated by 🔍 Workshop Sync Check · copilot · auto · 105.8 AIC · ⌖ 5.68 AIC · ⊞ 8.6K ·

  • expires on Sep 11, 2026, 1:14 AM UTC

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    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