File: workshop/04-github-actions-intro.md
Overall Score: 5.41 / 10.0 (corpus mean: 6.15)
Flagged Dimensions:
| Dimension |
Score |
Benchmark |
Delta |
| cognitive_load (concept_overload) |
6.8 / 10.0 |
≤15 new concepts |
-6.5 pts worth of penalty basis (28 concepts, highest in corpus) |
Note: checkpoint_quality shows 0.0 but the page has a complete ## :white_check_mark: Checkpoint section with 5 items — this is the rubric regex false positive documented in the scorecard issue, not a real gap, and is excluded from this finding.
Root Cause (≤ 2 sentences):
At 748 words the page is well within the length ideal, but it introduces 28 distinct new terms/fields (trigger, on, jobs, steps, runs-on, runner, self-hosted runner, uses, run, action, workflow-dispatch, and the four-row agentic-vs-classic comparison table concepts, plus a full labeling exercise) — almost double the 15-concept benchmark — packed into a single 5-minute "refresher" framed for skimming, not deep processing.
Evidence (quoted from the file):
A GitHub Actions workflow is a YAML file in .github/workflows/ that tells GitHub: when to run (on), what to run (jobs), how each job executes (steps)... | Trigger (on:) | Same — schedule, push, PR, dispatch | Same | | Runner (runs-on:) | GitHub-hosted or self-hosted | Same | | Steps | Shell commands you define | AI agent executes a plain-English task brief | | Output | Files, logs, deploy artifacts | GitHub comments, issues, PRs, or other API writes |
Learning Science Rationale:
Sweller's Cognitive Load Theory identifies "element interactivity" — how many new elements must be held in working memory simultaneously to make sense of the material — as the key driver of overload, independent of raw word count. This page's title ("in 5 Minutes") signals a fast, low-effort skim, but its actual element interactivity (28 concepts) contradicts that framing and risks learners disengaging or superficially skimming the comparison table without internalizing the trigger/job/runner/step distinctions needed for step 07.
Improvement Prompt (for an agent):
Open workshop/04-github-actions-intro.md. The "Why This Matters for Agentic Workflows" comparison table (Trigger/Runner/Steps/Output rows) duplicates concepts already covered in the "Quick Refresher" section and the "Label a sample workflow" exercise just above and below it. Remove the comparison table and instead add one short sentence directly after the "Quick Refresher" code block that states: "Agentic workflows use these same building blocks (trigger, runner, steps) — see docs.github.github.com/gh-aw/introduction/overview for the fully worked comparison." Keep the "Label a sample workflow" exercise, the "Try it: Explore a real workflow" activity, and the Checkpoint section unchanged. This should reduce new_concepts from 28 toward the 15-20 range while preserving the hands-on labeling exercise that already reinforces the core five concepts. Run `npx --yes markdownlint-cli2 "**/*.md"` afterward and fix any lint errors.
Expected Score After Fix: 6.5 / 10.0
Generated by 🔬 Curriculum Quality Evaluator · copilot · auto · 95.4 AIC · ⌖ 8.01 AIC · ⊞ 10.7K · ◷
File:
workshop/04-github-actions-intro.mdOverall Score:
5.41 / 10.0(corpus mean:6.15)Flagged Dimensions:
Note:
checkpoint_qualityshows0.0but the page has a complete## :white_check_mark: Checkpointsection with 5 items — this is the rubric regex false positive documented in the scorecard issue, not a real gap, and is excluded from this finding.Root Cause (≤ 2 sentences):
At 748 words the page is well within the length ideal, but it introduces 28 distinct new terms/fields (trigger,
on,jobs,steps,runs-on, runner, self-hosted runner,uses,run, action, workflow-dispatch, and the four-row agentic-vs-classic comparison table concepts, plus a full labeling exercise) — almost double the 15-concept benchmark — packed into a single 5-minute "refresher" framed for skimming, not deep processing.Evidence (quoted from the file):
Learning Science Rationale:
Sweller's Cognitive Load Theory identifies "element interactivity" — how many new elements must be held in working memory simultaneously to make sense of the material — as the key driver of overload, independent of raw word count. This page's title ("in 5 Minutes") signals a fast, low-effort skim, but its actual element interactivity (28 concepts) contradicts that framing and risks learners disengaging or superficially skimming the comparison table without internalizing the trigger/job/runner/step distinctions needed for step 07.
Improvement Prompt (for an agent):
Expected Score After Fix:
6.5 / 10.0