Skip to main content

Overview

SkillRise leverages Groq AI to provide intelligent, context-aware learning assistance. The platform offers three major AI features: a personalized chatbot, dynamic learning roadmaps, and adaptive quiz generation.

AI Architecture

Chatbot

Context-aware learning assistant with conversation history

Roadmaps

Personalized and custom learning path generation

Quizzes

Auto-generated chapter quizzes with AI recommendations

Groq Integration

AI Service Configuration

server/services/chatbot/aiChatbotService.js
Groq provides ultra-fast inference with the openai/gpt-oss-120b model, enabling real-time AI interactions.

Personalized AI Chatbot

Context Building

The chatbot builds rich user context from enrollment and performance data:
server/controllers/chatbotController.js
1

Data Collection

Gather user enrollment, progress, and quiz performance data.
2

Progress Calculation

Calculate completion percentage for each enrolled course.
3

Performance Analysis

Analyze recent quiz results and performance groupings.
4

Context Formatting

Format data into a natural language context for the AI.

System Prompt Generation

server/controllers/chatbotController.js

Chat Endpoint

server/controllers/chatbotController.js
The system prompt is rebuilt on every request to ensure the AI always has up-to-date information about the student’s progress.

AI-Generated Learning Roadmaps

Personal Roadmap

Generate a roadmap based on enrolled courses:
server/controllers/roadmapController.js
Roadmaps are generated dynamically based on real-time course progress, providing personalized learning paths.

Custom Topic Roadmap

Generate a roadmap for any topic:
server/controllers/roadmapController.js

AI-Generated Quizzes

Quiz Generation

Automatically generate quizzes from chapter content:
server/controllers/quizController.js

Quiz Submission with AI Recommendations

server/controllers/quizController.js
1

Score Calculation

Compare student answers with correct indices to calculate score.
2

Performance Grouping

Categorize performance: needs_review (≤40%), on_track (41-75%), mastered (>75%).
3

AI Recommendations

Generate personalized study recommendations based on wrong answers.
4

Result Storage

Save quiz results for progress tracking and chatbot context.

Performance Groups

Needs Review

Score ≤ 40%. Student should revisit chapter content.

On Track

Score 41-75%. Student has basic understanding but needs practice.

Mastered

Score > 75%. Student has strong grasp of the material.

JSON Parsing Strategy

Robust JSON extraction from AI responses:
server/controllers/roadmapController.js
Multiple parsing strategies ensure robust JSON extraction even when AI wraps responses in markdown code blocks.

Environment Variables

.env

Key Features

Chatbot receives real-time data about enrolled courses, progress, and quiz performance to provide personalized guidance.
Both personal (based on enrollments) and custom (any topic) roadmaps are generated with structured stages and time estimates.
Quizzes are auto-generated from chapter content and include AI-powered study recommendations based on performance.
Quiz results feed back into chatbot context, creating a closed loop of personalized learning assistance.

Best Practices

Refresh Context Frequently: Rebuild user context on every chatbot request to ensure AI has current information.
Validate AI Output: Always use Zod schemas to validate AI-generated JSON before using it in the application.
Limit Context Size: Use .slice(-20) on conversation history to keep context within token limits.
Structured Prompts: Use detailed prompts with exact JSON schemas to improve AI output consistency.

Next Steps

Analytics

Track learning time and quiz performance

Community

Connect with other learners for peer support

Course Management

Understand the content structure AI analyzes