Skip to content

[skill-activity] improve(side-quest-01-02): add prereq section and quick-practice activity - #2873

Draft
github-actions[bot] wants to merge 1 commit into
mainfrom
improve/env-reference-prereq-and-activity-98f4c86af9a41de0
Draft

[skill-activity] improve(side-quest-01-02): add prereq section and quick-practice activity#2873
github-actions[bot] wants to merge 1 commit into
mainfrom
improve/env-reference-prereq-and-activity-98f4c86af9a41de0

Conversation

@github-actions

Copy link
Copy Markdown
Contributor

What was improved

Added a Before You Start prereq section and a Quick practice: match the tool to the task self-test to workshop/side-quest-01-02-environment-reference.md.

Learner pain point addressed

This file scored 4.93/10 (lowest in the corpus, declining -2.38 from baseline). The rubric identified two primary drivers:

  1. Missing prereq section — the rubric floors pages without one at ~5/10.
  2. Bloom level too low (Remember) — the glossary page only asked learners to read, not apply.

Why it helps workshop flow

  • The prereq section tells learners exactly what they need before reading (an open Codespace or any terminal with gh), matching the pattern used across all other side quests.
  • The practice table turns passive reading into a 30-second self-test, confirming the glossary stuck before learners return to Step 1.
  • The collapsible answers preserve the reference feel while adding interaction without adding cognitive load for returning readers.

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 · 38.1 AIC · ⌖ 6.21 AIC · ⊞ 5.1K ·

  • expires on Aug 31, 2026, 4:50 AM UTC

- Add 'Before You Start' prereq section listing what learners need
  before using this page; fixes the rubric's missing-prereq penalty
  that was the primary score driver (floor at 5/10)
- Add 'Quick practice: match the tool to the task' self-test table
  with a collapsible answers block, raising the Bloom level from
  Remember to Apply
- Trim redundant phrasing in the intro callout

Addresses learner pain point: without a prereq section learners
couldn't tell at a glance whether to open a terminal before reading.
The practice table gives immediate confirmation that the glossary
landed before moving on.

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 Aug 30, 2026
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.

0 participants