| name | des-artifact-quiz |
| description | Use when the user wants to test understanding of a DES artifact, generate concept-check questions, or turn learning notes into a quiz. |
des-artifact-quiz
Purpose
Use this learning skill to generate a quiz from a DES artifact and its learning notes.
This skill helps the user check whether they understand the artifact purpose, related Data Engineering concepts, key decisions, trade-offs, upstream dependencies, downstream impacts, and common mistakes.
The goal is not memorization. The goal is applied understanding.
When To Use
Use this skill when:
- the user wants to test understanding of a DES artifact;
- the user asks for quiz questions after reading learning notes;
des-explain-artifact has produced learning notes;- the user wants to prepare for review, interview, report defense, or project explanation;
- the workflow router selects
des-artifact-quiz;
- Learning Mode requires a concept check.
Use this skill after:
- any DES main lifecycle artifact;
des-explain-artifact.
Do not use this skill to create or modify the source artifact.
Required Inputs
The agent should look for:
SOUL.md
knowledge/FUNDAMENTALS-MAP.md
Recommended input:
_des-output/learning-artifacts/{phase}-*-learning-notes.md
The agent may also inspect the source artifact:
_des-output/planning-artifacts/{phase-artifact}.md
If neither the learning notes nor the source artifact is available, stop and ask the user which artifact or phase to quiz.
Output File
Create or update:
_des-output/learning-artifacts/{phase}-artifact-quiz.md
Examples:
_des-output/learning-artifacts/08-ingestion-artifact-quiz.md
_des-output/learning-artifacts/10-silver-layer-artifact-quiz.md
_des-output/learning-artifacts/14-data-quality-artifact-quiz.md
Output Must Include
The quiz must include:
- quiz metadata;
- source artifact;
- DES phase;
- learning goal;
- concept-check questions;
- artifact-understanding questions;
- applied scenario questions;
- trade-off questions;
- common-mistake questions;
- answer key;
- scoring guide;
- recommended next action.
Quiz Types
Use these categories:
1. Concept Check
Tests whether the user understands the fundamental concept.
Example:
What is the difference between ingestion and transformation?
2. Artifact Understanding
Tests whether the user understands why the artifact exists.
Example:
Which section of the ingestion specification controls replay and recovery?
3. Applied Scenario
Tests whether the user can apply the concept to a real project.
Example:
An API changes field names without notice. Which part of the ingestion design should handle this risk?
4. Trade-off Question
Tests whether the user understands design choices.
Example:
When would batch ingestion be preferable to streaming ingestion?
5. Common Mistake Question
Tests whether the user can detect bad practice.
Example:
Why is it risky to drop source metadata in the Bronze layer?
Difficulty Levels
Use these levels:
Beginner
Intermediate
Applied
Challenge
Default mix:
Beginner: 30%
Intermediate: 40%
Applied: 20%
Challenge: 10%
On Activation
- Read this
SKILL.md completely.
- Read
customize.toml.
- Read
SOUL.md.
- Read
knowledge/FUNDAMENTALS-MAP.md.
- Identify source artifact or learning notes.
- Identify DES phase.
- Load only
steps/step-01-context-and-scope.md.
- Do not load step-02 or step-03 until instructed.
- Stop at every
HALT point.
- Do not create questions unrelated to the artifact or concept map.
- Do not use the quiz to introduce unsupported concepts.
Process Overview
This skill will:
- Identify the artifact or learning notes.
- Identify the DES phase.
- Map the phase to Data Engineering concepts.
- Generate quiz questions.
- Generate answer key and explanations.
- Add scoring guidance.
- Recommend next action.
Do not execute this overview directly. Follow the step files.
Guardrails
The agent must not:
- create trivia-only questions;
- ask questions that can be answered by memorizing headings only;
- invent project details not present in the artifact;
- test concepts not mapped to the phase;
- claim the user has mastered the topic based only on quiz generation;
- modify the source artifact.
HALT Policy
Stop when:
- no artifact, phase, or learning notes can be identified;
SOUL.md is missing;knowledge/FUNDAMENTALS-MAP.md is missing;- the artifact is too incomplete to generate meaningful questions;
- the user asks for answer evaluation but has not provided answers.
Quality Checklist
Handoff To The Next Skill
Recommend one of:
des-gap-teacher when available;des-explain-artifact if understanding appears weak;- next DES main lifecycle skill;
des-learning-path if the user wants a broader study plan.
