Meaning Directness

Evaluator last updated August 27, 2026.

Overview

The Meaning Directness evaluator assesses how directly a text communicates its meaning. It analyzes whether language is literal and explicit or relies on figurative, abstract, or implied meaning that requires interpretation.

At a glance


Inputs	Informational text to evaluate and grade level
Supported grades	3–12
Rubric	Student Achievement Partners (SAP) ↗‘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 used	Gemini 3 Flash preview (`gemini-3-flash-preview`)
Temperature	0

Getting started

Follow the Quickstart to start using this evaluator:

Access method
Evaluators playground	View in Platform ↗
SDK	Python ↗ and TypeScript ↗
GitHub	Python notebook ↗ Prompts (`system.txt` ↗ and `user.txt` ↗)

Inputs

Input	Description	Required
Text	Informational text to evaluate 10 - 10,000 words (< 1,200 words recommended)	Yes
Grade level	Target student grade level	Yes

Output

Field	Description
Complexity rating	Slightly complex: Confirm generated text uses literal, grade-appropriate language Language is literal and explicit Meaning is directly stated Minimal use of abstract, symbolic, ironic, and/or figurative language Almost entirely explicit, literal, and straightforward Moderately complex: Check whether occasional figurative language fits instructional goals Mostly literal language with occasional figurative or implicit meaning Occasional use of abstract, symbolic, ironic, and/or figurative language Primarily explicit, literal and straightforward Very complex: Plan scaffolding when figurative language is central to meaning Frequent figurative language or implied meaning requires interpretation Frequent use of abstract, symbolic, ironic, and/or figurative language Exceedingly complex: Flag texts that require heavy interpretive support before use Language relies heavily on abstraction, layered meaning, or sustained figurative expression Pervasive use of abstract, symbolic, ironic, and/or figurative language
Reasoning	Explanation of the rating based on language features
Meaning Directness features	Specific language features driving complexity (for example, idioms, metaphors, irony, or implicit meaning)
Grade context	Comparison of meaning directness demands with expectations for the provided grade
Instructional insights	Suggestions for scaffolding or teaching unconventional language features Example: Use meaning directness features, grade context, and reasoning together to identify which language features to pre-teach or clarify

Evaluator release history

Date	Changed
August 27, 2026	Minor prompt updates
March 20, 2026	First release

Understanding evaluators

Getting started

SDK API reference

Student-Facing Text evaluators

Feedback evaluators

Standards evaluators

Datasets

Resources

Overview

At a glance

Getting started

Inputs

Output

Evaluator release history

​Overview

​At a glance

​Getting started

​Inputs

​Output

​Evaluator release history

Overview

At a glance

Getting started

Inputs

Output

Evaluator release history