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
| Supported grades | 3–12 |
| Rubric | Student Achievement Partners (SAP) ↗‘s Qualitative Text Complexity Rubric for Informational Text ↗ (Conventionality) |
| Model used | Gemini 3 Flash preview (gemini-3-flash-preview) with temperature of 0 The evaluator was built and validated using this specific model and temperature. Other configurations will produce different results and may have lower accuracy. |
Getting started
Follow the Quickstart to start using this evaluator:| Access method | |
|---|---|
| Evaluators playground | View in Platform ↗ |
| SDK | Python ↗ and TypeScript ↗ |
| Other | 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 score |
|
| Reasoning | Detailed explanation of the rating, citing specific features in the text and referencing the expert guardrails (e.g., noting if the text relies on abstract qualities/rhetorical idealization, if vocabulary/background knowledge demands make a literal text vague for the grade level, or if it is strictly concrete/procedural) |
| Meaning directness features | Specific language features driving complexity (for example, idioms, metaphors, irony, or implicit meaning) |
| Grade context | How the meaning directness demands compare to general expectations for the provided target grade |
| Instructional insights | Actionable pedagogical suggestions for scaffolding the meaning directness features in the classroom |
Evaluator release history
| Date | Changed |
|---|---|
| August 27, 2026 | Minor prompt updates |
| March 20, 2026 | First release |