New Recap

/new-recap Skill

Purpose

Generate a Recap for an existing course. Each recap section is a condensed synthesis of the lesson (key concepts, formulas, takeaways) plus a fresh set of quiz questions distinct from the original section quiz. Once written, the Recap button appears automatically in the course sidebar for that course.

Step 1 — Interview

Ask each question one at a time. Wait for the user's answer before proceeding.

1a. Pick a course. Run: ls ~/.tutor/modules/courses/ Show the list and ask: "Which course should I generate a recap for?"

1b. Confirm language. Read ~/.tutor/modules/courses/{courseId}/config.json. Extract "language". Tell the user: "This course is in [English / Persian]. Do you want to keep that language for the recap, or switch?"

1c. Summary depth. Ask: "How detailed should each section summary be?

• Brief (~100 words) — key terms and formulas only
• Standard (~200 words) — key concepts with a sentence of context each
• Detailed (~300 words) — fuller synthesis with brief examples"

Step 2 — Generate content per section

Read the full config.json to get the ordered list of chapters and sections.

For each section in order:

1. Read ~/.tutor/modules/courses/{courseId}/sections/{sectionId}.md
2. Read ~/.tutor/modules/courses/{courseId}/sections/{sectionId}.quiz.json (if it exists) — note existing questions to avoid repetition

Generate two outputs before moving to the next section:

Summary ({sectionId}.md)

• Compact prose — no headings, no bullet lists unless the source uses them for a series of items
• Cover the key concepts, definitions, and formulas from the lesson
• Do not copy sentences verbatim; synthesize and rephrase
• Preserve all LaTeX ($...$ and $$...$$)
• Preserve all code fences with their language tags
• For Persian courses: write prose in Farsi; keep math and code LTR

Quiz ({sectionId}.quiz.json)

• 3–5 multiple-choice questions
• Must not repeat any question from the existing {sectionId}.quiz.json — check for overlap in concept and wording
• Questions may be more integrative or applied than the original quiz (the user has already studied the material)
• Each option should be plausible — avoid obviously wrong distractors
• Distribute correctIndex across 0, 1, 2, and 3 — do not put the correct answer at the same index for every question

Format:

[
  {
    "id": "rq1",
    "type": "multiple-choice",
    "question": "Question text (LaTeX OK)",
    "options": ["Option A", "Option B", "Option C", "Option D"],
    "correctIndex": 2,
    "explanation": "Why the correct answer is correct."
  }
]

Step 3 — Write files

Before writing anything: Check if ~/.tutor/modules/courses/{courseId}/recap/ already exists. If it does, tell the user: "A recap already exists for this course. Overwrite all files? (yes / no)" If the user says no, stop.

Create the directory if it does not exist.

For each section, write:

• ~/.tutor/modules/courses/{courseId}/recap/{sectionId}.md
• ~/.tutor/modules/courses/{courseId}/recap/{sectionId}.quiz.json

Announce each section as you write it: "Writing recap for: {sectionTitle}…"

Do not modify config.json — recap detection is directory-based.

Important: Do not use the chapter ID recap when creating new courses with /new-course — it would collide with the recap route.

Step 4 — Confirm

Tell the user:

• How many sections were covered
• "The Recap button now appears in the sidebar when you open this course."
• URL: http://localhost:3000/learn/{courseId}/recap

Quality Rules

1. Synthesis over quotation — rephrase; do not paste from the source lesson.
2. Fresh questions — read the existing quiz first; avoid any conceptual overlap.
3. Persian support — prose in Farsi, math/code stays LTR.
4. Shuffle correctIndex — vary across 0, 1, 2, 3 within each quiz file.
5. IDs — use rq1, rq2, … for recap quiz question IDs to distinguish them from original quiz IDs.
6. Depth — honor the user's chosen depth (brief/standard/detailed) consistently across all sections.