Skip to main content
Evaluator last updated March 13, 2025.

Overview

The Subject Matter Knowledge evaluator assesses the subject-matter complexity of reading passages:
  • Evaluates how much prior knowledge a text relies on
  • Lists key concepts in the text
  • Evaluates whether students have likely encountered these concepts before

At a glance

Input typeInformational text
Supported grades3-12
RubricSAP ↗‘s Qualitative Text Complexity Rubric for Informational Text ↗
The evaluator was built and validated using the model and temperature below (other configurations will produce different results and may have lower accuracy):
Model usedgemini-3-flash-preview
Temperature0

Getting started

Follow the Quickstart to start using this evaluator:
Access method
Evaluators PlaygroundView in the Learning Commons Platform ↗
SDKTypeScript ↗
Python notebookView in GitHub ↗
PromptsView in GitHub ↗

Inputs

InputDescriptionRequired
Target grade levelEnables grade context evaluationYes
Text typeInformational text
Optimal length: 200-1,000 words
Yes

Output

FieldDescription
Complexity rating
  • Slightly complex: Relies on everyday, practical knowledge; includes simple, concrete ideas
  • Moderately complex: Relies on common practical knowledge and some discipline-specific content knowledge; includes a mix of simple and more complicated, abstract ideas
  • Very complex: Relies on moderate levels of discipline-specific or theoretical knowledge; includes a mix of recognizable ideas and challenging abstract concepts
  • Exceedingly complex: Relies on extensive levels of discipline-specific or theoretical knowledge; includes a range of challenging abstract concepts
ReasoningSynthesized explanation of the decision
Identified topicsList of topics in the text
Curriculum checkClassification of topics as general or specialized
Assumptions and scaffoldingAnalysis of assumed prior knowledge vs. explained content
Friction analysisAnalysis of the gap between concrete description and abstract meaning

Interpreting results

OutputHow to use
Complexity rating
  • Slightly complex: Confirm text relies on everyday knowledge students likely have
  • Moderately complex: Plan light scaffolding for discipline-specific terms
  • Very complex: Pre-teach key concepts before independent reading
  • Exceedingly complex: Flag texts that assume extensive prior knowledge
Identified topics + Assumptions and scaffoldingMatch text to what students have already encountered

Example: Use identified topics, curriculum check, and friction analysis to decide what to pre-teach or explain in the text

Accuracy and validation

This evaluator is provided as Early access. Comprehensive accuracy measures are not yet available. Validation testing is ongoing.
We assessed performance against an expert-annotated dataset of texts from the CLEAR Corpus ↗, rated by 3 experts, rather than traditional static benchmark metrics.
MetricDescriptionResult
Complexity score accuracyHow accurately the evaluator determines text complexity compared to the expert annotated dataset.87% based on agreement with 3 experts assessing ~30 texts
Expert agreement rateThe agreement rate between the evaluator and experts on a sample of 10 evaluated texts.100%
For more information on our validation process, see Accuracy.

Evaluator release history

DateChanged
March 13, 2026First release