| name | reva-session-designer |
| description | Design complete, pedagogically rich session materials for one BTech CS session at REVA University. Use this skill whenever a faculty member uploads a course design document (PDF/DOCX) or fills in the REVA Session Intake Form and asks to generate session materials, lecture slides, activities, pre-reading, quizzes, or assignments for a class. Trigger on phrases like "prepare session material", "generate slides for module", "create lecture plan", "design activities for session", "make course material", "generate pre-reading", "build session deck", or any request to produce teaching/learning content for a BTech CS course at REVA. Always use this skill — even if the request seems partial (e.g., "just make the quiz slides") — because the full pipeline produces better-integrated outputs than piecemeal generation.
|
| compatibility | Requires bash, web_search, create_file, present_files tools. Uses pptx skill for slide generation. |
REVA Session Designer
Produces a full session material package for one session within a BTech CS module at REVA University:
- PPTX slide deck — REVA-branded, activity-based, ready to present
- HTML interactive companion — embedded quizzes, interactive activities, animations
Step 0 — Read the PPTX skill first
Before generating any slides, read /mnt/skills/public/pptx/SKILL.md and its pptxgenjs.md reference.
The PPTX skill governs all slide creation mechanics, QA, and visual polish standards.
Step 1 — Intake
If the user uploads a PDF or DOCX course design document:
Extract the following fields (ask the user to confirm or fill gaps):
- Course name, course code, semester, year
- Module number and title
- Session number within module (e.g., Session 2 of 4)
- Session topic / title
- Course Outcomes (COs) addressed — with CO statements
- Bloom's taxonomy levels targeted
- Pre-requisite knowledge students should already have
- Key concepts to be covered (list)
- Suggested activities / lab context (if any)
- Duration (default: 60 minutes)
- Any special notes (guest talk, demo, flipped classroom, etc.)
If the user does not have a document — use the Intake Form:
Present the REVA Session Intake Form (see references/intake-form.md) and collect all fields.
Clarification rule:
Do NOT proceed to Step 2 until you have at minimum:
- Session topic, CO(s) addressed, Bloom's level, key concepts list, duration.
Step 2 — Research Phase (run in parallel)
Once intake is complete, run all three searches simultaneously:
2a. Curated pre-reading resources
Search: "[topic] introduction tutorial BTech CS" site:geeksforgeeks.org OR site:cs.stanford.edu OR site:mit.edu OR nptel
Aim for 2–3 high-quality links (NPTEL, GeeksForGeeks, MIT OCW, NPTEL, Programiz preferred).
Summarise each in one line.
2b. Curated video resources
Search: "[topic] explained" YouTube OR NPTEL site:youtube.com
Find 2–3 videos under 15 minutes. Include title, channel, approx duration, URL.
Prefer: NPTEL, CS Dojo, Abdul Bari, MIT OpenCourseWare, 3Blue1Brown (for math-adjacent topics), Fireship (for web/programming topics).
2c. Activity ideas and analogies
Search: "[topic] teaching activity analogy classroom CS" to find any published active learning ideas, analogies, or demos specific to this topic.
Step 3 — Pedagogical Planning
Before writing any slides, produce an internal Session Blueprint (show this to faculty for confirmation before generating slides):
SESSION BLUEPRINT
─────────────────────────────────────────────
Course: [name] | Session [X] of [Y] | [duration] min
Topic: [topic]
COs addressed: [CO list]
Bloom's level: [Remember / Understand / Apply / Analyse / Evaluate / Create]
ARC:
1. HOOK (5 min) → [describe hook: surprising fact, demo, question, story]
2. PRE-READING RECAP (5 min) → [what students should have read; quick recall activity]
3. LEARNING OUTCOMES (2 min) → [3–5 LOs, Bloom's-tagged]
4. CONCEPT BUILD (25 min) → [chunked into 2–3 sub-topics; note where Socratic Q&A fits]
5. ACTIVITY (10 min) → [quiz / case / simulation / think-pair-share — specify which]
6. PRACTICE (8 min) → [problem set / peer exercise / quick coding challenge]
7. DEBRIEF + SYNTHESIS (3 min) → [what did we learn; connect back to CO]
8. ASSIGNMENT BRIEF (2 min) → [task, rubric, Bloom's tag, submission format]
Activity selection rationale: [why these activities for this Bloom's level + topic]
Neuro-cognitive notes: [spaced retrieval, dual coding, interleaving, worked example — which apply here]
─────────────────────────────────────────────
Pedagogical principles to apply — see references/pedagogy.md for full guidance. Key rules:
- Apply Cognitive Load Theory: chunk new content into ≤3 concepts per slide; use worked examples before problems
- Apply Dual Coding: pair every concept explanation with a visual (diagram, analogy illustration, timeline)
- Apply Retrieval Practice: embed at least one unannounced recall question before the activity segment
- Apply Socratic Questioning: for analytical/application topics, use a question-chain sequence of 3–5 escalating questions instead of direct explanation (see
references/pedagogy.md §Socratic)
- Concept check quiz is mandatory every session; Kahoot-style competitive quiz when topic has ≥5 discrete facts to recall
- CO–Bloom's alignment must be visible on the Learning Outcomes slide
Step 4 — Slide Deck Generation (PPTX)
Target: 20–30 slides for a 60-minute session. Scale proportionally for other durations.
REVA Brand Standards
- Primary: REVA Orange
#F7A35B
- Dark: REVA Grey
#4A4C55
- Background: White
#FFFFFF (content slides) / REVA Grey (title, section dividers)
- Accent: Light orange tint
#FDE8D0 for highlight boxes
- Font: Plus Jakarta Sans — Bold for titles, Regular for body
- Fallback fonts (PPTX): Calibri (title), Calibri Light (body)
- Logo: Place REVA wordmark top-right on title slide and section dividers (use text "REVA University" in REVA Orange if no logo asset available)
- CO badge: Small pill/tag bottom-left of Learning Outcomes slide and Assignment slide
Mandatory Slide Set (in order):
| # | Slide Type | Notes |
|---|
| 1 | Title slide | Session title, course code, module, session no., faculty name placeholder, date placeholder |
| 2 | Pre-reading | 2–3 resources with one-line descriptions + URLs; "Read before this session" header |
| 3 | Videos to watch | 2–3 curated videos, title + channel + duration + URL |
| 4 | Learning Outcomes | 3–5 LOs with Bloom's verb tags; CO mapping shown as badges |
| 5 | Hook | Surprising fact, provocative question, or short scenario — no definitions yet |
| 6–N | Concept build slides | Chunked; max 3 concepts per slide; dual-coded (text + visual); Socratic Q slides interspersed |
| N+1 | Retrieval check | "Before we go further — what do you recall?" — 2 quick MCQs, answers revealed on click |
| N+2 | Activity slide | Full-screen activity prompt (quiz, case study, think-pair-share, or scenario) |
| N+3 | Practice | Problem / challenge slide with worked example hint |
| N+4 | Debrief | Key takeaways; connect back to LOs and CO |
| N+5 | Assignment | Task description, Bloom's level tag, rubric table (criteria / marks), submission format |
Slide design rules (from PPTX skill):
- Every slide must have a visual element — no text-only slides
- Use icon-in-circle motif for lists; orange accent boxes for key definitions
- Dark (REVA Grey) background for title, section dividers, hook, and debrief slides
- Light background for all content slides
- Socratic question slides: full-screen dark background, single large question in white, pause icon
Step 5 — Interactive HTML Companion
Generate a single self-contained HTML file alongside the PPTX. It must include:
HTML Required Sections:
- Session header — title, CO, Bloom's level, duration badge (REVA branded)
- Pre-reading panel — clickable resource cards with links
- Video panel — clickable video cards with thumbnails (YouTube embed or link)
- Interactive concept check quiz — MCQ with instant feedback, score tracker, REVA-styled
- Kahoot-style rapid quiz (if topic warrants) — timed questions, points, leaderboard display (single-player simulation)
- Activity widget — appropriate to topic:
- Matching/drag-and-drop for classification topics
- Scenario-choice branching for case studies
- Animated diagram for process/algorithm topics
- Socratic question reveal sequence for analytical topics
- Practice problem — with "Show hint" and "Show solution" toggles
- Assignment card — task, rubric table, Bloom's tag, submission format
HTML technical standards:
- Single file, no external dependencies except CDN (use Tailwind CDN, no build step)
- REVA colour variables:
--reva-orange: #F7A35B; --reva-grey: #4A4C55; --reva-light: #FDE8D0
- Mobile-responsive
- Smooth scroll navigation between sections
- Print-friendly (assignment card should print cleanly)
Step 6 — QA
PPTX QA:
Follow the full QA loop from the PPTX skill:
- Extract text with
markitdown — check for missing content
- Convert to images — visually inspect for overlap, overflow, contrast issues
- Fix and re-verify
HTML QA:
- Open in bash with
python3 -m http.server or verify file structure
- Check all interactive elements have correct answer keys
- Verify all URLs from web search are live (curl check)
Step 7 — Deliver
Copy final files to /mnt/user-data/outputs/:
[CourseCode]_[ModuleNo]_Session[N]_Slides.pptx[CourseCode]_[ModuleNo]_Session[N]_Interactive.html
Call present_files with both files.
Provide a brief summary to faculty:
- Session arc (8-step sequence)
- Activity type used and rationale
- Kahoot quiz: yes/no
- Assignment Bloom's level
- CO(s) addressed
Reference Files
references/intake-form.md — The structured intake form to present when no document is uploadedreferences/pedagogy.md — Full pedagogical and neuro-cognitive principles guide
