Skip to content

[skill-activity] fix(02a): add gh auth status verification and fix checkpoint accuracy#1829

Merged
pelikhan merged 1 commit into
mainfrom
fix/02a-setup-codespace-verify-63ed9cc4d2832786
Jul 22, 2026
Merged

[skill-activity] fix(02a): add gh auth status verification and fix checkpoint accuracy#1829
pelikhan merged 1 commit into
mainfrom
fix/02a-setup-codespace-verify-63ed9cc4d2832786

Conversation

@github-actions

Copy link
Copy Markdown
Contributor

What was improved

Three consistency issues in workshop/02a-setup-codespace.md (lowest-scoring file at 7.67/10, declining trend):

  1. Missing auth verification — the step told learners to run gh --version only, but the surrounding prose claimed they would confirm being logged in to github.com. Added gh auth status as a second verification command so the instructions match what learners actually need to check.

  2. Inaccurate checkpoint item — the checkpoint said Codespaces are free for public repositories, but the step instructs learners to create a Private repository. Updated to the accurate statement: Codespaces are available on the free tier (60 h/month), regardless of repository visibility.

  3. Misleading TIP callout — the terminal-ready tip linked to the gh aw install troubleshooting page (not yet installed at this step). Replaced with an actionable inline hint to run gh auth login if auth status shows an error.

Learner pain point addressed

Learners could believe their environment was verified when it was not — gh was installed but not confirmed as authenticated. This caused silent failures later when authenticated gh commands ran. The checkpoint mismatch also confused learners who created a private repo as instructed but saw a checkpoint item implying they needed a public one.

Workshop flow impact

All changes are self-contained within 02a-setup-codespace.md. No cross-links or other files affected.

Warning

Firewall blocked 1 domain

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

  • awmgmcpg

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

network:
  allowed:
    - defaults
    - "awmgmcpg"

See Network Configuration for more information.

Generated by 🧩 Workshop Skill Activity Author · 37.8 AIC · ⌖ 6.03 AIC · ⊞ 5.1K ·

  • expires on Jul 23, 2026, 3:35 AM UTC

- Add 'gh auth status' command alongside 'gh --version' so learners
  actually verify they are authenticated, matching the existing prose
  that claims to confirm login.
- Fix checkpoint item that said 'free for public repositories' — the
  repo is created as Private in this step, and Codespaces are available
  on the free tier (60 h/month), not only on public repos.
- Fix TIP callout that linked to the gh-aw install troubleshooting page,
  which is irrelevant at this setup step; replace with actionable
  'gh auth login' recovery hint.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@github-actions github-actions Bot added documentation Improvements or additions to documentation skill-activity workshop labels Jul 22, 2026
@pelikhan pelikhan self-assigned this Jul 22, 2026
@pelikhan
pelikhan marked this pull request as ready for review July 22, 2026 07:50
@pelikhan
pelikhan merged commit 78c56b4 into main Jul 22, 2026
1 check passed
@pelikhan
pelikhan deleted the fix/02a-setup-codespace-verify-63ed9cc4d2832786 branch July 22, 2026 07:51
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation skill-activity workshop

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant