githubnext / githubnext/gh-aw-workshop

[curriculum-eval] side-quest-11-06-anthropic-key.md: cognitive_load — 26 new concepts from redundant troubleshooting bullets in a short page

Closed Beginner friendly
#3,416 0 comments 0 reactions 0 assignees View on GitHub
curriculum documentation quality
Dominant language
JavaScript
Stars
47
Forks
19
Avg merge
8h 54m
Merged PRs (30d)
50

Description

**File:** `workshop/side-quest-11-06-anthropic-key.md`
**Overall Score:** `5.39 / 10.0` (corpus mean: `6.14`)

**Flagged Dimensions:**

| Dimension | Score | Benchmark | Delta |
|---|---|---|---|
| cognitive_load | 7.2 | 10 (≤800 words, ≤15 concepts) | -2.8 (665 words is fine; 26 new concepts is the driver) |
| active_learning | 3.5 | ≥3 activity density | -0.5 (density 1.05 vs 3.0 ideal) |
| checkpoint_quality | 0.0 | 10 (≥4 checklist items) | -10.0 (scorer defect — see Root Cause) |

**Flagged issue `concept_overload` confirmed:** despite being only 665 words, the page packs 26 new concepts (`ANTHROPIC_API_KEY`, `engine: claude`, `api.anthropic.com`, `network.allowed`, repository secrets flow, key-rotation caveat, whitespace pitfalls, naming pitfalls, `copilot-requests: write` removal, `gh aw compile`, etc.) — nearly double the ideal.

**Root Cause (≤ 2 sentences):**
The page interleaves a step-by-step secret-creation walkthrough, four separate "common mistakes" bullet lists (wrong name, whitespace, closed tab, missing allow-list), and a frontmatter code sample in a short 665-word page, so new-concept density per 100 words is unusually high even though total length is well within budget. `checkpoint_quality` reads 0.0 due to the same corpus-wide `## :white_check_mark: Checkpoint` vs. `## ✅ Checkpoint` scorer mismatch; the actual checkpoint has 5 usable items.

**Evidence (quoted from the file):**
> - **Wrong name**: any variation (`anthropic_api_key`, `ANTHROPIC-API-KEY`, `CLAUDE_API_KEY`) will cause a silent auth failure. The name must be exactly `ANTHROPIC_API_KEY`.
> - **Copied with extra whitespace**: pasting from some tools adds a leading space. Delete and re-create the secret if you are unsure.
> - **Closed the Anthropic tab before saving**: you cannot retrieve the key again. Delete the key at [console.anthropic.com]((console.anthropic.com/redacted) and generate a new one.
> - **Network allow-list missing**: the `claude` engine needs outbound access to `api.anthropic.com`. Make sure it is in your `network.allowed` list (shown in the frontmatter example below).

**Learning Science Rationale:**
Sweller's Cognitive Load Theory notes that troubleshooting/error-avoidance content carries high intrinsic load per item because each "common mistake" requires the learner to hold both the correct procedure and its failure mode in working memory simultaneously; four such paired concepts stacked in one collapsible block, on top of the core setup steps, pushes this short page's concept count well past what a single pass can consolidate, even though raw word count looks modest.

**Improvement Prompt (for an agent):**
```
Open workshop/side-quest-11-06-anthropic-key.md. Consolidate the four "Common mistakes with this secret" bullets into a single compact table (Mistake | Fix) instead of four prose-heavy bullets, and remove the redundant restatement of the whitespace/naming warnings that already appear earlier in the page (in the "Store the key as a repository secret" numbered steps and the tip callout). Keep exactly one troubleshooting reference per failure mode. This should reduce new_concepts from 26 toward 16-18 without cutting any unique guidance. Run `npx --yes markdownlint-cli2 "**/*.md"` after editing and fix any lint errors.
```

**Expected Score After Fix:** `6.6 / 10.0`

> Generated by [🔬 Curriculum Quality Evaluator](https://github.com/githubnext/gh-aw-workshop/actions/runs/35026063971) · copilot · auto · 76.1 AIC · ⌖ 8.13 AIC · ⊞ 9.5K · [◷](https://github.com/search?q=repo%3Agithubnext%2Fgh-aw-workshop+is%3Aissue+%22gh-aw-workflow-call-id%3A+githubnext%2Fgh-aw-workshop%2Fcurriculum-evaluator%22&type=issues)
> - [x] expires on Sep 16, 2026, 9:39 PM UTC

Contributor guide

No contributing guide indexed for this repository

Research direction

Open workshop/side-quest-11-06-anthropic-key.md and review the numbered secret-storage steps, tip callout, and “Common mistakes with this secret” bullets. Consolidate the four mistake bullets into one Mistake | Fix table, remove redundant warnings while preserving unique guidance, then run npx --yes markdownlint-cli2 "**/*.md". Done means the page retains one troubleshooting reference per failure mode and passes the markdown lint check.

Written by the indexing model from the issue text.

Assessment

Tech stack
markdown
Domain
documentation
Issue type
Documentation
Difficulty
2/5
Estimated time
1-3 hours
Activity status
Active
Clarity
Clearly specified
Newbie friendliness
86/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.