check-understanding

SKILL.md

Check Understanding

Test your knowledge of a completed phase from the AI Engineering from Scratch course.

Activation

This skill activates when the user says things like:

/check-understanding 3 or /check-understanding deep-learning

"quiz me on phase 2"

"test phase 1"

"check my understanding of transformers"

"do I know phase 3"

"am I ready for the next phase"

Input

Accepts a phase number (0-19) or a phase name as argument. If no argument is provided, ask the user which phase they want to be tested on by listing all 20 phases.

Phase Map
Map the argument to the correct phase directory under phases/:

Input
Directory
Phase Name

0, setup, tooling
00-setup-and-tooling
Setup & Tooling

1, math, math-foundations
01-math-foundations
Math Foundations

2, ml, ml-fundamentals
02-ml-fundamentals
ML Fundamentals

3, deep-learning, dl
03-deep-learning-core
Deep Learning Core

4, cv, computer-vision, vision
04-computer-vision
Computer Vision

5, nlp
05-nlp-foundations-to-advanced
NLP -- Foundations to Advanced

6, speech, audio
06-speech-and-audio
Speech & Audio

7, transformers
07-transformers-deep-dive
Transformers Deep Dive

8, generative, gen-ai, genai
08-generative-ai
Generative AI

9, rl, reinforcement-learning
09-reinforcement-learning
Reinforcement Learning

10, llms, llm, llms-from-scratch
10-llms-from-scratch
LLMs from Scratch

11, llm-engineering, llm-eng
11-llm-engineering
LLM Engineering

12, multimodal
12-multimodal-ai
Multimodal AI

13, tools, protocols, mcp
13-tools-and-protocols
Tools & Protocols

14, agents, agent-engineering
14-agent-engineering
Agent Engineering

15, autonomous
15-autonomous-systems
Autonomous Systems

16, multi-agent, swarms
16-multi-agent-and-swarms
Multi-Agent & Swarms

17, infrastructure, production, infra
17-infrastructure-and-production
Infrastructure & Production

18, ethics, safety, alignment
18-ethics-safety-alignment
Ethics, Safety & Alignment

19, capstone, projects
19-capstone-projects
Capstone Projects

Procedure

Step 1: Resolve the Phase

Parse the argument. If it is a number, validate it is between 0 and 19 inclusive. If the number is out of range, tell the user: "Phase [N] does not exist. Valid phases are 0-19." and show the full list for them to pick from. If it is a name or keyword, look it up in the Phase Map above. If the keyword does not match any entry in the map, tell the user: "Unknown phase '[keyword]'. Pick from the list below:" and present all 20 phases. If no argument is provided, ask the user to pick from the full list.

Step 2: Read the Phase Content

If the repo is cloned (a phases/ directory exists in or above the current directory), find all lesson directories under phases/<phase-dir>/ and read each lesson's docs/en.md. If it is not cloned, get the phase's lesson list from the Contents section of the README (fetch https://raw.githubusercontent.com/rohitg00/ai-engineering-from-scratch/main/README.md), then fetch each lesson's docs/en.md from the same raw base URL. These documents contain the teaching material you will generate questions from.

Read as many lesson docs as needed to cover the full breadth of the phase. If a phase has many lessons (15+), prioritize reading a representative spread: first few, middle, and last few.

Step 3: Generate 8 Questions

Create exactly 8 multiple-choice questions drawn from the lesson content you just read:

Questions 1-4: Conceptual (What/Why)
These test understanding of ideas, definitions, and reasoning. Examples:

"What is the purpose of X?"

"Why does Y happen when Z?"

"Which statement best describes the relationship between A and B?"

"What problem does X solve?"

Questions 5-8: Practical (How/Build)
These test applied knowledge and implementation awareness. Examples:

"How would you implement X?"

"Which approach correctly solves Y?"

"What is the correct order of steps to build Z?"

"If you observe X during training, what should you do?"

Each question must have exactly 4 answer options labeled A, B, C, and D. Exactly one option is correct. The wrong options should be plausible but clearly incorrect to someone who studied the material.

Tag each question with the specific lesson it draws from (e.g., "Lesson 03: Matrix Transformations").

Step 4: Present Questions One at a Time

Use the AskUserQuestion tool (or equivalent interactive prompt) to present each question individually. Format:

Question 1/8 (Conceptual) -- from Lesson 03: Matrix Transformations

What is the geometric interpretation of an eigenvalue?

A) The angle of rotation applied by the matrix
B) The factor by which the eigenvector is scaled during transformation
C) The determinant of the transformation matrix
D) The rank of the matrix after transformation

Wait for the user's answer before moving to the next question.

Answer isolation

Keep the correct option and explanation private until the learner answers the
current question. Never use a real answer letter, a likely answer, or the
generated answer distribution in a reply-format hint. When a plain-text hint
is needed, use exactly: Reply with one letter: <A|B|C|D>.

Step 5: Track and Score

Keep a running tally:

Total correct out of 8

For each wrong answer, record: the question number, the user's answer, the correct answer, and which lesson it came from

Step 6: Show Results

After all 8 questions, display the score and grade:

7-8 correct: Mastered
If the phase is 19 (Capstone Projects): "You have mastered Phase 19, the final phase." Add "Congratulations, you have completed the entire curriculum." only when you can verify the rest of the curriculum is done (a LEARNING.md in the current directory whose Path table shows Phases 0-18 as Done or Skip); a single phase quiz does not prove full completion.
Otherwise: "You have a strong grasp of Phase N. You are ready to move on to Phase N+1: [next phase name]."

5-6 correct: Almost
"Solid foundation. Review these specific areas before moving on:"
Then list the lessons tied to the missed questions.

3-4 correct: Developing
"You are building understanding but need to revisit some lessons:"
Then list each missed question with the lesson to re-read.

0-2 correct: Start Over
"This phase needs more time. Work through the lessons again from the beginning, focusing on:"
Then list all missed topics.

Step 7: Wrong Answer Breakdown

For every question the user got wrong, show:

Question N: [question text, abbreviated]
Your answer: B
Correct answer: C -- [the correct option text]
Why: [1-2 sentence explanation of why C is correct]
Review: Lesson NN -- [lesson name] (phases/<phase-dir>/NN-<lesson-slug>/docs/en.md)

Step 8: What Next?

End by offering three choices:

Retake this quiz -- generate a fresh set of 8 questions from the same phase

Try another phase -- pick a different phase to test

Explain a topic -- ask about any concept from the questions you missed

Wait for the user's choice and act accordingly.

Rules

Avoid repeating questions on retakes until the question pool is exhausted. Once exhausted, reshuffle or rephrase questions for subsequent retakes.

Questions must be directly grounded in the lesson docs, not general knowledge.

Do not show the correct answer until after the user responds.

Do not include literal answer letters in examples of how the learner should
reply; use <A|B|C|D> as the placeholder.

Keep question text concise. One or two sentences max.

Wrong options must be plausible. No joke answers.

If a phase has no lesson docs written yet (no en.md files found), tell the user: "Phase N does not have lesson content yet. Pick a completed phase to quiz on."