Chalkie

View saved version →

---
name: creation
description: "Read before creating lessons, quizzes or documents: gather the teaching brief, plan connected lessons, choose supported themes or recurring characters, resolve valid settings, and follow generation through to completion."
---

# Create lessons, quizzes and documents

Use this guide before calling `create_lessons` or `create_documents`. Use the named read tools below for live account and resource data. Skill files and references are packaged with the plugin; do not depend on runtime skill URI reads.

## Gather a short teaching brief

Call `get_creation_context` for the teacher's country, language and plan, plus supported grades, languages, templates, themes and limits. Use details already supplied in the conversation. Ask only for missing information that changes what you will create, preferably in one short question with two or three parts.

- **What:** the topic and learning focus, or the existing Chalkie lesson/series to use as the source. Infer a teaching lesson, standalone quiz or printable document from the request; ask if the intended format is unclear.
- **Who:** the class year/grade or age range. Resolve a named year against the grades for the teacher's country. If the country or age-to-grade mapping remains ambiguous, ask which school system or class year they mean. Never guess an ID or ask the teacher to supply one.
- **Purpose and size:** for a broad topic, ask what pupils should learn. For slides, ask about slide count or lesson length when that would change the scope. For a vague document request, ask whether they want practice, a check of understanding, or another activity. Use specific instructions already given rather than asking again.

For example, if the teacher says only "Make a fractions lesson", ask "Which year group is this for, and should it introduce fractions or practise a particular skill?" If they already ask for a 6-slide Year 5 equivalent-fractions lesson and their account supplies an unambiguous school system and language, proceed without another questionnaire.

Use the account's country and language unless the teacher specifies otherwise; validate them against creation options. Ask for a missing language only if it cannot be inferred confidently. Do not make theme, image style, reading level, vocabulary, curriculum, or differentiation mandatory questions. Offer them when relevant to the brief, and otherwise leave optional settings unset so Chalkie applies its defaults. Do not claim browser-saved creation preferences are available through the account resource.

## Map the brief to supported inputs

### Slide lessons

Each `create_lessons.items[]` needs `topic`, `grade_id` and `language`. Match the grade label and country to the ID in creation options, and match language to its supported value. Put the learning goal, requested duration, prior knowledge, teaching approach and other requirements in `additional_instructions`.

Pass `slide_count` when the teacher requests a count; keep it within the returned plan limit. A duration is teaching context, not a slide count: do not silently treat 30 minutes as 30 slides. If a requested setting exceeds the plan or is unavailable, explain and agree on an alternative before changing that explicit requirement.

If one requested lesson exceeds the slide limit, offer a shorter lesson or a split into separate lessons, then **stop and wait for the teacher to choose**. Do not call a creation tool in that reply, even if their requested total could fit a batch. Saying "I'll split it" is not agreement from the teacher.

Use Chalkie's default theme unless the teacher requests a particular theme or custom look. For custom lesson designs, select Go Wild from `get_creation_context.options.lesson_themes` using `theme_id`, and put the teacher's visual preferences in `additional_instructions`. Do not add instructions to bypass the selected theme. Colour, readability or differentiation preferences alone do not require Go Wild. Go Wild applies 

Preview of the first 4,000 characters. Read full instructions →

Referenced files: 2 — file references are metadata, not package contents.

View saved version →

---
name: recreation
description: "Create a fresh lesson, quiz or activity-sheet family from saved prompt settings. Use when the teacher wants another generated version or an updated prompt while keeping the original."
---

# Recreate teaching resources

Resolve the source with `search_resources`. Use names and context to select the intended item; ask only when matches remain ambiguous. Never invent IDs or ask the teacher to find internal IDs.

Use `recreate_resource` for “make another version,” “edit the prompt,” or “generate this again with…” when the teacher wants a new AI result. It uses the owned source's saved prompt and generation settings, validates them against current permissions and plan limits, and creates new IDs without changing the original.

Supply only requested overrides in `changes`. `additional_instructions` replaces the full saved brief; call `get_generation_settings` with the resource type and ID first if you need to preserve its requirements while adding a change. New resources are created outside folders. New generation uses the normal quota and can produce different content and images.

For worksheets, `changes` also accepts `template`, `difficulty_levels` and `standard_ids`. Read `get_creation_context` for supported templates and difficulty levels, and use `search_curriculum_standards` to resolve requested alignment to real IDs from one curriculum. Each supplied field replaces the saved selection; omit it to keep the existing setting. Each requested difficulty creates a separate new worksheet, so changing to challenge only produces one challenge worksheet. Do not add extra versions or curriculum alignment unless requested. An empty `standard_ids` list clears alignment on topic-based worksheets; worksheets based on a lesson or series require a non-empty replacement because they otherwise inherit their source's standards.

For quizzes, use `resource_type: "lesson"`. Recreation preserves the quiz type, selected question types and saved source. Use `changes.question_count` or `changes.question_types` for quiz settings; the count excludes the cover. Do not use `slide_count` for quizzes.

Supported recreation is a quiz, a slide lesson (including a standalone version of a series lesson) or an activity-sheet difficulty family. Documents based on a lesson or series inherit their topic, grade, country and language from that source; use topic-based `create_documents` for a deliberately different audience or topic. Whole-series, workbook, legacy-worksheet and uploaded-file recreation are not supported by this tool. Explain that limit; do not silently drop attachments or change the resource type.

Treat recreation results like creation results: preserve every returned ID, never recreate an item that was already saved, and call `preview_resource` with the returned resource type and ID. Follow the creation skill for generation handling.

For a worksheet family, preview each requested difficulty using its ID in `versions`. A replacement brief describes one worksheet; Chalkie applies it separately to each difficulty. Never ask each worksheet to contain all difficulty versions.