Skip to main content
Evaluator last updated September 23, 2025.

Overview

The Grade Level Appropriateness evaluator assesses whether AI-generated text is suitable for independent reading at a specified grade band. The evaluator considers:
  • Flesch-Kincaid grade level
  • Word count
  • Text structure – Organization complexity, connections between ideas, text features
  • Language features – Vocabulary, sentence complexity, figurative or abstract
  • Purpose – Explicitly vs. not explicitly stated, concrete vs. abstract
  • Knowledge demands – Discipline-specific knowledge, references, allusions
  • Student background knowledge – What students at a given grade level would already know

At a glance

Input typeInformational text
Supported gradesK–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-2.5-pro (gemini-2.5-pro-preview-06-05)
Temperature0.25

Getting started

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

Inputs

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

Output

FieldDescription
GradeGrade band where a student can read the text independently
ReasoningReasoning for the output grade level (quantitative score, qualitative features, assumed background knowledge)
Alternative gradeText is appropriate for supported reading (e.g., read-aloud)
Scaffolding neededSupports needed for supported reading (e.g., pre-teaching of vocabulary)

Interpreting results

OutputHow to use
Grade + ReasoningEvaluate and improve the complexity of your AI-generated content

Example: Validate that your LLM prompts produce grade-appropriate content; aggregate reasoning across runs to diagnose and fix systemic complexity issues
Alternative grade + Scaffolding neededAdapt content for a wider range of learners.

Example: Make scaffolding suggestions (e.g., vocabulary pre-teaching, read-aloud) to help educators adapt content for mixed classrooms

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 CLEAR Corpus ↗ and Common Core Appendix B exemplar texts:
MetricDescriptionResult
Overall accuracyHow accurately the evaluator determines grade level appropriateness compared to expert annotations.81% (70 correct out of 86 texts)
Baseline comparisonHow the evaluator’s accuracy compares to a simple, unrefined grade-level appropriateness prompt.58% more accurate than a naive LLM baseline
For more information on our validation process, see Accuracy.

Evaluator release history

DateChanged
September 23, 2025First release