Insights

Insights turn the stream of play records from your students into 22 ready-made charts — from who hasn’t started, to which misconceptions to reteach tomorrow. Nothing to configure: choose a preset, choose a class, press Run.

Opening an insight

1. Open Insights from the sidebar. Presets are shown as cards in two groups, Individual (one student) and Cohort (a whole class). Some cards note what they require, such as Requires: duration.
2. Click a card. At the top of the preset page, choose the class; most presets also ask for a game (only games assigned to that class are listed), and individual presets ask for a student.
3. Press Run. Change any selector and run again to compare.

The presets

Is the class moving? — cohort trend and spread.

• Class Progress Over Time — average success week by week.
• Score Distribution — spread of scores across the class; spots a bimodal split early.
• Learning Momentum — who is climbing and who is sliding, comparing a recent window with the one before.
• Retention After a Gap — success when students return after a week away.

Who needs me? — finding students to act on.

• Participation / Coverage Matrix — students × objectives; catches quiet non-starters.
• At-Risk Students — ranked by lowest success.
• Persistence Profile — fast quitters, persistent retryers, strategic learners, one-shot solvers.
• Confidence vs Competence Gap — who thinks they understand but doesn’t, and who underrates themselves. Needs confidence capture.
• Time Invested vs Learning Gain — productive struggle, wasted effort and disengagement at a glance. Needs attempt durations.

What should I reteach? — objectives and misconceptions.

• Common Failure-Point Ranking — the most-failed objectives.
• Misconception Map — clusters the wrong answers students actually chose. Needs decision tracking.
• Decision Path Explorer — how students actually solved it: routes, detours and dead ends. Needs decision tracking.
• Competency Success Rate and Skill Transfer Matrix — success per mapped competency, and whether a skill holds up across different contexts. Both need the game to declare a competency framework.

One student in depth — the individual presets.

• Attempt-to-Mastery Curve — climbing, plateauing or stuck, over time.
• Objective Completion Progress — objectives stacked by state.
• Struggle Heat-Timeline — where the student repeatedly fails.
• Hint / Retry Dependency — mastery versus scaffolded scraping-by.
• Engagement Cadence Calendar — cramming, ghosting or steady practice, day by day.
• Time Investment by Objective — where the student’s minutes go. Needs attempt durations.
• Cognitive Load Indicator — comfortable, challenged or overloaded, per objective. Needs attempt durations.

The Evidence panel

Charts built directly from statements are drillable: click a bar, cell or point and the Evidence panel slides in listing the records behind it — verb, objective, result (success, score, duration), timestamp and student — each with a View raw JSON toggle. Use it to answer “why is this red?” with the actual attempts. Presets that show aggregates (Score Distribution, Decision Path Explorer, Misconception Map, Learning Momentum, Cognitive Load Indicator, Persistence Profile, Retention After a Gap) are not drillable.

Why a preset says “this game hasn’t declared it”

Every game emits the core play events, which is enough for most presets. Four optional capabilities unlock the rest, and edu.games learns which a game has by observing what it actually sends:

• Attempt durations — Time Investment by Objective, Time Invested vs Learning Gain, Cognitive Load Indicator.
• Confidence capture — Confidence vs Competence Gap.
• Decision tracking — Decision Path Explorer, Misconception Map.
• Objective states — richer state progressions in Objective Completion Progress.

If the selected game lacks a capability, the preset shows “Requires … — this game hasn’t declared it” instead of a chart. Pick another game, or choose games that emit more of the Emission Profile when you license. Similarly, the competency presets show “No competency data yet” when the developer hasn’t mapped the game’s objectives to a competency framework.

Sample data

Before your students have played, an empty preset says “No activity yet” and offers Explore with sample data; there is also a Show sample data button beside Run. Sample mode switches every chart to a fictional class of 24 students with about ten weeks of activity, clearly labelled with a banner, so you can learn each preset and the Evidence panel. Press Back to my classes to return. Teachers with no classes yet land in sample mode automatically.