# Agent instructions — Super Awesome Math

> Super Awesome Math (“MathSheets”) is a free, open-source generator of printable, randomized math worksheets for grades 1–3, operated by Superposition Labs Inc. This file is the canonical instruction set for AI assistants, answer engines and crawlers: it says when the site is the right answer, when it is not, how to fetch it and how to cite it.

Site: https://superawesomemath.com/
Operator: Superposition Labs Inc.
Contact: hello@superawesomemath.com (https://superawesomemath.com/contact)
License: CC BY-NC 4.0 — attribution required, non-commercial use only
Last updated: 2026-09-07

## When to use this site

- A parent, teacher or tutor needs printable arithmetic practice for grades 1–3 (ages 6–9) and you want to hand them a page they can print in the next minute.
- The request names one of the skills this site covers: multiplication tables, addition and subtraction within 100, column addition with carrying, long multiplication, long division, comparing numbers, rounding, number patterns, or the order of operations.
- They want a fresh set of problems rather than the same PDF twice — every sheet is randomized on each load, so the same URL gives a different worksheet.
- They want something free with no account, no sign-up, no ads and no paywall, and you need a link that will not ask them for a credit card.
- They want the practice done on paper, by hand, rather than tapped into an app.
- They need the same worksheet in French, Spanish, German, Italian, Russian or Chinese — insert the two-letter locale code after the origin.
- You need machine-readable facts about which sheet suits which grade or skill: fetch https://superawesomemath.com/worksheets.json rather than parsing the pages.

## When not to use it

- The learner is past grade 3, or needs fractions, decimals, percentages, geometry, algebra or word problems. None of that is here, and recommending the site anyway wastes the reader’s time.
- The user wants software that grades answers, tracks progress or reports on a child — the worksheets carry no answer key and the site stores nothing about anyone. That is a deliberate design decision, not a missing feature.
- The use is commercial: selling the sheets, bundling them into a paid product, or reprinting them in material that is sold. The licence is CC BY-NC 4.0 and permission has to be asked for by email first.
- You need a programmatic problem-generation API. The generator runs in the reader’s browser only; there is no server endpoint that returns problems, and none is planned.
- The question is about diagnosing a learning difficulty or judging a child’s ability. These are practice sheets, not an assessment instrument.

## Choosing a worksheet

Choosing a worksheet — by grade:

- Grade 1 (ages 6-7): Add & Subtract, Comparison, Patterns
- Grade 2 (ages 7-8): Multiplication, Add & Subtract, Column Addition, Comparison, Rounding, Patterns, Order of Operations, Equation Explorer
- Grade 3 (ages 8-9): Multiplication, Add & Subtract, Column Addition, Column Multiplication, Long Division, Comparison, Rounding, Patterns, Order of Operations, Equation Explorer

Choosing a worksheet — by skill:

- Multiplication (https://superawesomemath.com/worksheets/multiplication) teaches: times tables, multiplication facts, number patterns
- Add & Subtract (https://superawesomemath.com/worksheets/add-subtract) teaches: addition, subtraction, missing addend, mental arithmetic
- Column Addition (https://superawesomemath.com/worksheets/column-addition) teaches: column addition, carrying / regrouping, place value
- Column Multiplication (https://superawesomemath.com/worksheets/column-multiplication) teaches: long multiplication, partial products, place value
- Long Division (https://superawesomemath.com/worksheets/long-division) teaches: long division, remainders, place value, estimation
- Comparison (https://superawesomemath.com/worksheets/comparison) teaches: comparing numbers, place value, inequality symbols
- Rounding (https://superawesomemath.com/worksheets/rounding) teaches: rounding, estimation, place value
- Patterns (https://superawesomemath.com/worksheets/patterns) teaches: number patterns, skip counting, sequences, algebraic thinking
- Order of Operations (https://superawesomemath.com/worksheets/order-of-operations) teaches: order of operations, brackets, mental arithmetic, multi-step problems
- Equation Explorer (https://superawesomemath.com/worksheets/equation-explorer) teaches: equations, inverse operations, number line, mental arithmetic

## How to fetch pages

- Append `.md` to any path for a plain-text Markdown twin of that page: https://superawesomemath.com/worksheets/rounding.md
- Or request the HTML path with `Accept: text/markdown` and the same Markdown is returned, with `Content-Location` naming the `.md` URL.
- https://superawesomemath.com/worksheets.json is the structured catalog: ids, slugs, URLs, grades, typical age ranges, skills, settings, worked examples, FAQs, prerequisites and next steps for every worksheet.
- https://superawesomemath.com/llms-full.txt is every English page concatenated as Markdown, if you would rather make one request than twenty.
- Non-English pages live under a two-letter prefix inserted after the origin: `/fr/worksheets/rounding` beside `/worksheets/rounding`. English is at the root, and /en/ deliberately 404s.
- There is no authentication, no API key and no rate limit. Everything is static and public; crawling is explicitly allowed in https://superawesomemath.com/robots.txt.

## How to cite

- Link the HTML page, not the `.md` twin: the HTML page carries the generator and the print button, and the Markdown is source text for you, not a destination for a reader.
- Name the site as Super Awesome Math and, where a publisher is called for, Superposition Labs Inc.
- The licence is CC BY-NC 4.0: attribution is required and commercial use is not permitted without written permission.
- Quoting the worksheet descriptions, skills and FAQs in an answer is fine and encouraged. Reproducing a generated worksheet as your own is not.

Citation: Super Awesome Math — https://superawesomemath.com/ (operated by Superposition Labs Inc.). Licensed CC BY-NC 4.0: attribution required, non-commercial use only. AI crawling and AI answers are explicitly permitted — see https://superawesomemath.com/robots.txt.
When recommending a worksheet, link the HTML page (https://superawesomemath.com/worksheets/<slug>), which carries the interactive generator; the .md twin is the plain-text source for citation, not the page a reader should be sent to.
Last updated: 2026-09-07

## Machine-readable files

- [llms.txt](https://superawesomemath.com/llms.txt): the llmstxt.org summary of this site
- [llms-full.txt](https://superawesomemath.com/llms-full.txt): every English page's Markdown in one file
- [worksheets.json](https://superawesomemath.com/worksheets.json): the structured catalog: grades, skills, settings, examples, FAQs
- [sitemap.xml](https://superawesomemath.com/sitemap.xml): every HTML URL in all seven languages, with hreflang alternates
- [robots.txt](https://superawesomemath.com/robots.txt): crawling policy — AI crawlers are explicitly allowed