Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.learningcommons.org/llms.txt

Use this file to discover all available pages before exploring further.

Evaluator last updated February 18, 2025.

At a glance

Input typeInformational text
Supported grades3–12
The Sentence Structure Evaluator assesses the complexity of sentence structure in informational texts relative to a specified grade level. It:
  • Identifies sentence features in the text, including sentence type composition, average words per sentence, subordinate clause ratios, and concepts per sentence.
  • Assigns an overall complexity rating using an LLM, combined with statistical thresholds for sentence features.

Model and prompt

For instructions on running the evaluator, see Running an evaluator. This evaluator runs as a two-step pipeline. Each step uses a different approach.
Step 1: Sentence analysis
MethodPython functions using textstat ↗ + LLM for feature calculation, then deterministic normalization
Step 2 — Complexity assignment
Model usedGPT-4o
Temperature0
PromptsView prompts ↗
NotebookView notebook ↗
Other configurations will produce different results and may have lower accuracy. The evaluator must be run in two stages — combining them into a single step reduces accuracy.

Inputs

RequirementSupportedRequired
Target grade levelEnables grade context evaluationYes
Text typeInformational text
optimal length: 100–200 words (max ~1,200 characters)
Yes

Output

Description
AnswerSentence structure complexity rating
ReasoningExplanation of the rating based on identified sentence features and grade context

Interpreting results

This evaluator returns one of the following ratings, along with reasoning for you to use to determine your best course of action. Complexity ratings are relative to the target grade level you provide.
RatingMeaning
Slightly complexMainly simple, short sentences with very low subordination. In Grades 3–4, no advanced complex sentences are present.
Moderately complexA mix of simple and compound sentences with some complex constructions. In Grades 3–4, sentence length and subordination fall within moderate ranges. In Grades 5–12, no more than two advanced complex sentences.
Very complexLonger, more elaborate sentences with multiple clauses and high subordination. In Grades 5–12, three or more advanced complex sentences are present.
Exceedingly complexDense, intricate sentences with a high degree of subordination; sentences often contain multiple concepts. In Grades 5–12, 65% or more of sentences are advanced complex sentences.

Accuracy and validation

This evaluator is provided as Early access. Comprehensive accuracy measures are not yet available. Validation testing is ongoing.
We assessed performance on an expert-annotated dataset of ~480 texts for Grade 3 and ~480 texts for Grade 4. Accuracy has been most extensively validated on Grades 3–4. We are still evaluating the performance for grades 5-12. For more information, see Accuracy.
MetricResult
53% agreement for Grade 3
54% agreement for Grade 4
94%
26% more accurate
Dataset sourceCLEAR Corpus ↗

Evaluator release history

DateChanged
February 18, 2026Added grades 5-12.
September 23, 2025First release.