Use cases
How to use an AI worksheet generator without shipping a wrong answer key
A worksheet is a physical artifact with a right answer attached. Specify the items, make the model compute the key instead of recalling it, and check the sheet before the photocopier does it for you.
Try this exact task
“Make a 24-item two-step equations worksheet for Year 8, with a checked answer key.”
The staged prompt tells OpenCraft to build the items in code, substitute every printed answer back into its printed question, and report any item the check could not verify. You review the full prompt before sending it.
- Skill, year group, and item count
- Number ranges and difficulty ladder
- The objective text, copied from your own source
- Printable worksheet and separate key
- Answers computed and verified in code
- The generator script, for the next version
Use the complete prompt
Create a printable practice worksheet for me. Ask for the skill being practised, the exact objective text, the year group, the item count, the number ranges and constraints, the difficulty ladder, the item forms, the working space, and the paper size. Then write and run a short Python program that builds the items and computes every answer, substitutes each printed answer back into its printed question to verify it, uses exact fractions rather than decimals, rejects duplicate or near-duplicate items, and reports any item it could not verify instead of printing it. Deliver an editable worksheet document, a separate answer key, and the generator script so I can produce another version with new numbers.
A worksheet generator makes a student-facing artifact
The deliverable is the sheet in a student's hands
A worksheet is not a document about teaching. It is the thing that comes out of the photocopier twenty-eight times, gets written on in pencil, and is marked against a key. That makes it unusually easy to judge. Either the items practise the skill, or they do not. Either the page has room to work in, or it does not. Either the key is right, or you spend the lesson apologising for question 17.
If the output you got has objectives, a timing column, and a differentiation table, you asked for a different artifact. That is the teacher's planning document, and it belongs in the AI lesson plan generator workflow. A worksheet generator's job starts after the plan exists and one line of it says “independent practice, twenty minutes.”
Four things the sheet has to get right
- The item set. Items that practise one skill, are not the same item four times with different numbers, and do not quietly require a second skill the class has not met.
- The progression. A ladder a student can climb alone, because nobody is standing next to them.
- The layout. Working space, legible at 100% in black and white, no colour-only cues, nothing clipped at the margin.
- The key. Correct. This is the one that fails, and it fails without looking like it failed.
Specify the items, not the topic
Use this six-step workflow
- Name the skill and paste the objective text from your source.
- Fix the item count and the difficulty ladder.
- State number ranges, item forms, and distractor rules.
- Make the model compute the answers, never recall them.
- Check the key and print one copy before the class set.
- Keep the generator so the next version costs a minute.
Number ranges are the difficulty control
“Make a fractions worksheet for Year 6” is a request for anything. The generator will pick its own difficulty, and it will pick the middle, so the sheet will be too easy for a third of the class and impossible for another third. Difficulty in practice items lives almost entirely in the numbers: the size of the operands, whether a sign flips, whether a division comes out whole, whether a denominator is one the student has automatised.
Write those as constraints. “Denominators drawn from 2, 3, 4, 6, and 8. No answer greater than one. No two items sharing the same pair of denominators.” A constraint like that is also a machine check later, which is the second reason to write it down.
Worked spec: two-step equations
Skill: solve ax + b = c for x. Learners: Year 8, first week after one-step equations. 24 items in four blocks of six. Block 1: a positive, b positive, integer solutions 1–12. Block 2: b negative. Block 3: a negative. Block 4: a is a unit fraction. Every solution an integer between −12 and 12. Six lines of working space per item, two items per row. Key on a separate page.
A weak sheet gives 24 items in random order and a key beneath them. A useful one makes each block a step a student can notice, and arrives with proof that all 24 answers were computed.
Distractors are error modes, not decoys
If the sheet is multiple choice, say what each wrong option is for. “One distractor from a sign error, one from dividing before subtracting, one from the correct answer with the operations reversed.” Distractors invented for plausibility teach nothing and occasionally teach the wrong thing. Add one mechanical rule: no distractor may equal the correct answer, and no two options in an item may be equal. Both are one line of code and both catch real generated sheets.
Assume the answer key is wrong until something has checked it
This is the failure mode, not a footnote
A model asked for thirty answers will produce thirty confident ones. Some will be wrong, and the wrong ones look exactly like the right ones — there is no hedging, no lower confidence, no visible seam. Arithmetic is the worst case, because generating variants of one template by changing the numbers is precisely the operation that degrades accuracy.
“performance of all models declines when only the numerical values in the question are altered”
Mirzadeh et al., GSM-Symbolic
The same paper reports that adding a single clause which looks relevant but contributes nothing to the solution dropped accuracy by up to 65% across the models tested. A word problem is a pile of such clauses. So the honest position is not “check a few answers.” It is: an unverified key is not a key.
Make the model compute, not remember
Two mechanics remove most of the risk, and they are cheap.
Build the item backwards from the answer. Pick the solution first, then construct the question around it. For ax + b = c, choose x and a and b, then compute c. The key is now correct by construction, and difficulty constraints become filters on the parameters rather than hopes about the output.
Verify forwards, independently. Take the printed question and the printed answer, substitute one into the other, and assert they match. Do it on the exact strings that will be printed, not on the variables in memory, because that also catches formatting bugs. Use exact arithmetic — Python's fractions.Fraction rather than floats — so 1/3 does not print as 0.33 and then fail its own check.
NIST's generative AI profile names confabulation — confidently presented false content — as a specific risk of these systems. A worksheet key is a dense, low-redundancy list of facts with no prose around them to make an error look odd. It is close to the worst possible place to trust recall.
Worked example: 24 two-step equations with a verified key
What OpenCraft actually runs
OpenCraft's runCode tool starts a durable job in a real Python sandbox attached to the conversation, so the model does not describe a calculation, it executes one. Files the job writes into its outputs/ folder come back as downloadable artifacts. The sandbox workspace persists between turns, which matters more than it sounds: the generator script is still there next turn, so “same rules, new numbers, and make block 4 harder” is a re-run with a different seed rather than a fresh guess.
For the document itself, makeDoc turns reviewed Markdown into an editable .docx plus a doc-styled HTML preview you can print from the browser. If the sheet needs a diagram — a number line, a labelled shape — an SVG artifact is checked by a deterministic linter that flags overlapping and out-of-canvas text, so the model gets told its labels collide instead of shipping a figure nobody can read. Re-running the same filename stacks versions rather than overwriting, so worksheet A and worksheet B stay side by side.
The run, end to end
- You give the spec above: skill, 24 items, four blocks, ranges, and the layout rules.
- The job writes a generator: choose x, a, b within the block's constraints, compute c, reject any item whose parameters repeat an earlier item's, keep going until the block is full.
- The same program re-solves each printed equation from its printed text and compares with the printed key. It prints one check line per item, so a failure is visible in the job output rather than on the page.
- The items and key go into Markdown, and
makeDocreturns an editable document plus its preview. - You solve three items chosen at random by hand, print one copy at 100%, then run the class set.
The interesting part is step 3. Rejection and regeneration are normal — a duplicate pair of parameters, a solution that lands outside the stated range — and a run that reports zero rejections across four blocks of tight constraints is worth a second look, because it usually means the checks were not actually wired to the printed strings. You can also compare AI models if you want a cheaper one for the routine sheets and a stronger one for word problems.
The checks that catch a bad worksheet
Six minutes, before the photocopier
| Check | How to run it | What it catches |
|---|---|---|
| Computed key | Substitute every printed answer into its printed question | Plausible arithmetic that is simply wrong |
| Spot-solve | Do three randomly chosen items by hand | A checker that verified the wrong thing |
| Answer distribution | List the key and look at it as a set | Every answer positive, or option C eleven times |
| Duplicate scan | Compare item parameters, not item text | Six items repeated four times with new numbers |
| Skill match | Tally items against the stated objective | Practice for the neighbouring skill |
| Reading load | Read the word problems aloud | Difficulty that is reading, not the target skill |
| Print test | One copy, 100%, black and white, correct paper size | Clipped columns, no working space, colour-only cues |
The print test is the one people skip and the one that costs a lesson. Screen layout lies about margins, and a sheet that assumes colour becomes a grey puzzle in the copier. Print it, put a pencil on it, and see whether there is anywhere to write.
What a worksheet cannot do
Practice is not assessment
Retrieval practice is genuinely well evidenced. The 2013 review by Dunlosky and colleagues for the Association for Psychological Science rated practice testing and distributed practice as the highest-utility techniques among the ten it examined, ahead of familiar habits such as rereading and highlighting. That is a good reason to hand out worksheets. It is not a reason to believe a finished sheet tells you what a student understands.
A score on unsupervised practice conflates knowing, guessing, copying, and running out of time. What you learn from a worksheet is mostly in the working, not the answer — which is an argument for leaving room to write and for reading a few sheets properly rather than totting up ticks.
Generated practice can drill the wrong thing convincingly
This is the specific danger of a fast generator. Thirty fluent, well-formatted, correctly keyed items can still be practice for a procedure the class already has, or for a slightly different skill than the one you named, or for a strategy you were about to move them off. Nothing on the page reveals this. The sheet looks like a good sheet. Volume is the easiest thing to generate and the least informative thing about quality.
It cannot see your class, or certify a standard
The generator does not know who reads slowly, who has an access arrangement, which context will land badly, or what went wrong last week. Those belong in the brief, in your words. And do not let a model supply a standard code from memory: paste the exact code and wording from the official source your school uses, whether that is the Common Core mathematics standards or a national curriculum document. A sheet labelled with a benchmark it does not actually address is worse than an unlabelled sheet, because it stops anyone from checking.
For the planning document that sits above the worksheet, see the AI lesson plan generator guide, or browse the OpenCraft use-case library for other deliverables.
Sources
- GSM-Symbolic: Understanding the Limitations of Mathematical Reasoning in Large Language Models Mirzadeh et al., arXiv
- Improving Students' Learning With Effective Learning Techniques: Promising Directions From Cognitive and Educational Psychology Association for Psychological Science
- Artificial Intelligence Risk Management Framework: Generative Artificial Intelligence Profile National Institute of Standards and Technology
- Mathematics Standards Common Core State Standards Initiative
Frequently asked questions
What is an AI worksheet generator?
It is software that turns a skill, a year group, and a set of constraints into printable practice items plus an answer key. The useful ones handle item generation, difficulty ordering, page layout, and an editable file you can change next term. They do not decide what your class needs to practise.
Can AI create a worksheet with an answer key?
Yes, and this is the part that most often fails silently. A model asked for twenty-four answers will produce twenty-four plausible ones. Ask instead for a short program that computes the answers, substitutes each printed answer back into its printed question, and refuses to output any item that does not check out.
Are AI-generated maths worksheets accurate?
Not reliably, when the answers are written rather than computed. Apple researchers found that model accuracy on grade-school maths problems drops when only the numbers in a question change, which is exactly what happens when you ask for thirty variants of one template. Computed and re-checked answers avoid the failure mode entirely.
Can I get a printable PDF or an editable Word worksheet?
Yes. Ask for an editable document rather than a flattened image, keep it, and print from it. The editable file is what makes version B cheap: next term you change six items and the number ranges, not the layout, the header, or the working space.
Can an AI worksheet generator match a curriculum standard?
Only if you supply the standard. Paste the exact code and wording from your own official source into the brief. A model recalling a standard code from memory can produce something that reads like a real benchmark and is not one, and a worksheet labelled with the wrong code is worse than one with no label.
What is the difference between an AI worksheet generator and an AI lesson plan generator?
A worksheet generator produces the artifact the student writes on: items, difficulty progression, working space, and a key. A lesson plan generator produces the teacher's planning document: objectives, timings, differentiation, and assessment. They are different deliverables with different failure modes, and a tool that is good at one is not automatically good at the other.