[curriculum-eval] side-quest-11-06-anthropic-key.md: cognitive_load — 26 new concepts in a 685-word setup guide

Closed Beginner friendly
  • Is something wrong?
#5,257 0 comments 0 reactions 0 assignees View on GitHub

Maintainers usually reply within 1 day

Nobody has claimed this yet.

Assessment

Difficulty
2/5
Estimated time
1-3 hours
Newbie friendliness
62/100
Issue type
Documentation
Clarity
Mostly clear
Activity status
Active
Tech stack
github-actions, markdown
Domain
documentation

Research direction

The file to change is workshop/side-quest-11-06-anthropic-key.md; start with the intro paragraph, which links many terms inline, and the numbered steps that describe UI or CLI actions. Trim the intro to two sentences, link each term only on first use, and turn the actions into short command blocks such as gh secret set ANTHROPIC_API_KEY and the engine: claude frontmatter snippet. Done when the Checkpoint still has five items, the concept count is about 15 or fewer, and npx --yes markdownlint-cli2 "**/*.md" passes.

Written by the indexing model from the issue text.

Description

curriculum documentation quality

File: workshop/side-quest-11-06-anthropic-key.md
Overall Score: 5.37 / 10.0 (corpus mean: 6.06)

Flagged Dimensions:

Dimension Score Benchmark Delta
cognitive_load 7.2 ≥ 8 (≤ 15 concepts) −0.8 (26 concepts)
active_learning 3.4 ≥ 10 (density ≥ 3) −6.6 (density 1.02)

Root Cause (≤ 2 sentences):
Intro and step text pack dense inline links and terms (engine, secrets, frontmatter, network allowlist, compile) into a short guide. The step-by-step actions have few commands/code blocks relative to prose.

Evidence (quoted from the file):

By default, agentic workflows run on the GitHub Copilot engine. If you prefer to use Claude ...

Learning Science Rationale:
Mayer's coherence and signalling principles: linking every term inline adds extraneous load. Defining a term once, then using plain words, and putting each action in a code block or checklist reduces split attention.

Improvement Prompt (for an agent):

Edit workshop/side-quest-11-06-anthropic-key.md: link each concept only on first use, trim the intro to 2 sentences, convert the UI/CLI actions into short numbered commands or code blocks (e.g. gh secret set ANTHROPIC_API_KEY, the engine: claude frontmatter snippet, gh aw compile), and keep the Checkpoint at 5 items. Target ≤ 15 new concepts. Run npx --yes markdownlint-cli2 "**/*.md".

Expected Score After Fix: 6.5 / 10.0 (≈ 8.5 once the rubric detection bug is fixed)

Generated by 🔬 Curriculum Quality Evaluator · copilot · auto · ~36 AIC · ⌖ ~1 AIC · ⊞ 5K · ◷

  • expires on Nov 3, 2026, 4:04 AM UTC
Dominant language
JavaScript
Stars
56
Forks
40
Avg merge
2d 14h
Merged PRs (30d)
13

Getting set up

Open in Codespaces

Starts the project's dev container in your browser, under your own GitHub account.

  • No Dockerfile or Docker Compose file
  • No pull request template
  • No contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from githubnext/gh-aw-workshop

All issues in githubnext/gh-aw-workshop

Similar issues

More JavaScript issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.