| name | des-gap-teacher |
| description | Use when the user wants personalized feedback on their understanding of a DES artifact, quiz answer, explanation, or Data Engineering concept. |
des-gap-teacher
Purpose
Use this learning skill to diagnose the user's learning gaps from a DES artifact, quiz answer, self-explanation, design decision, or learning notes.
This skill does not merely mark answers as right or wrong. It identifies conceptual gaps, incorrect assumptions, weak reasoning, missing trade-offs, and misunderstood Data Engineering principles.
The goal is to help the user improve both the artifact and their Data Engineering thinking.
When To Use
Use this skill when:
- the user answers a
des-artifact-quiz;
- the user explains a DES artifact in their own words;
- the user asks “tôi hiểu vậy đúng không?”;
- the user asks “tôi đang thiếu gì?”;
- a DES artifact has weak or missing sections;
- the user wants feedback before moving to the next phase;
- the workflow router selects
des-gap-teacher;
- Learning Mode requires personalized diagnosis.
Use this skill after:
des-explain-artifact;des-artifact-quiz;- any DES main lifecycle artifact;
- any user-submitted explanation or answer.
Do not use this skill to create the main artifact from scratch.
Required Inputs
The agent should read:
SOUL.md
knowledge/FUNDAMENTALS-MAP.md
The agent should inspect one or more of:
_des-output/planning-artifacts/{phase-artifact}.md
_des-output/learning-artifacts/{phase}-*-learning-notes.md
_des-output/learning-artifacts/{phase}-artifact-quiz.md
User-provided evidence may include:
quiz answers
self-explanation
design rationale
artifact draft
confusion/questions
If there is no user answer, artifact, or explanation to diagnose, stop and ask for evidence.
Output File
Create or update:
_des-output/learning-artifacts/{phase}-learning-gap-report.md
Examples:
_des-output/learning-artifacts/08-ingestion-learning-gap-report.md
_des-output/learning-artifacts/10-silver-layer-learning-gap-report.md
_des-output/learning-artifacts/14-data-quality-learning-gap-report.md
Output Must Include
The Learning Gap Report must include:
- source evidence reviewed;
- DES phase;
- related lifecycle concepts;
- related undercurrents;
- what the user understands correctly;
- missing concepts;
- incorrect assumptions;
- weak reasoning;
- artifact impact;
- downstream risk;
- recommended study actions;
- recommended artifact corrections;
- next learning skill.
Gap Categories
Use these categories:
Conceptual Gap
Artifact Gap
Decision Gap
Trade-off Gap
Terminology Gap
Lifecycle Connection Gap
Governance / Quality Gap
Evidence Gap
Severity Levels
Use these severity levels:
Low
Medium
High
Blocking
Definitions:
Low = minor wording or shallow explanation issue
Medium = concept partially understood but incomplete
High = misunderstanding can cause poor artifact/design decisions
Blocking = misunderstanding prevents safe progress to the next DES phase
On Activation
- Read this
SKILL.md completely.
- Read
customize.toml.
- Read
SOUL.md.
- Read
knowledge/FUNDAMENTALS-MAP.md.
- Identify evidence to diagnose.
- Identify DES phase.
- Load only
steps/step-01-context-and-evidence.md.
- Do not load step-02 or step-03 until instructed.
- Stop at every
HALT point.
- Do not invent user understanding.
- Do not claim a gap without evidence.
- Do not be harsh; explain gaps as learning opportunities.
Process Overview
This skill will:
- Identify the evidence to diagnose.
- Map evidence to DES phase and Data Engineering concepts.
- Identify correct understanding.
- Identify missing concepts.
- Identify wrong assumptions.
- Explain why each gap matters.
- Recommend study actions and artifact corrections.
- Recommend next learning step.
Do not execute this overview directly. Follow the step files.
Guardrails
The agent must not:
- shame the user;
- overstate mastery or failure;
- invent gaps without evidence;
- diagnose based on missing context when a HALT is required;
- rewrite the entire artifact unless explicitly requested;
- skip downstream risk analysis;
- mark the user ready for the next phase if Blocking gaps remain.
HALT Policy
Stop when:
- no evidence is available;
- DES phase cannot be identified;
SOUL.md is missing;knowledge/FUNDAMENTALS-MAP.md is missing;- the user asks for personalized diagnosis but only generic context is available;
- the evidence is too vague to assess.
Quality Checklist
Handoff To The Next Skill
Recommend one of:
des-socratic-coach if the user should reason through the concept interactively;des-explain-artifact if the user needs to revisit fundamentals;des-artifact-quiz if the user should retry a quiz;- next DES main lifecycle skill if no High or Blocking gaps remain;
- improve current artifact if artifact gaps are significant.
