Skip to content

TechSuvo108/SkillQuest

Repository files navigation

👇🏻 Click the image below to watch the SkillQuest Demo Video

Watch the SkillQuest Demo Video

🎓 SkillQuest

An AI-powered gamified learning platform that transforms STEM and non-STEM subjects such as science, mathematics, English, history, and more through interactive games, personalized learning paths, and career guidance.

🚀 Built as a hackathon project for DUHacks 5.0 to reimagine learning and career discovery


🌐 Live Demo

Try the application live:
🔗 Visit SkillQuest


📖 Overview

This project was developed as part of DUHacks 5.0, focusing on building an AI-powered, scalable, and engaging learning platform within hackathon constraints.

SkillQuest is a gamified learning platform designed to support both STEM and non-STEM subjects, helping students move beyond rote memorization toward conceptual understanding and long-term skill development.

Students learn through interactive games, practice modes, challenges, badges, and leaderboards while the system continuously tracks accuracy, time, consistency, and subject mastery.

In addition to learning, SkillQuest provides an AI-based career guidance system that analyzes student skills and interests to recommend suitable career paths, learning roadmaps, and future growth opportunities.


✨ Core Features

🔐 Student Authentication — Email & password–based signup and login using Firebase.

🎮 Gamified Learning Zone — Multiple concept-driven games instead of plain MCQs.

🧠 Practice & Challenge Modes — Stress-free learning or competitive scoring.

🏆 Badges & Leaderboards — Subject-wise, weekly, and consistency-based rankings.

🔥 Consistency Heatmap — GitHub-style daily learning activity visualization.

📊 Performance Analytics — Accuracy vs time, level progression, and mastery graphs.

📚 Teacher Notes — Verified teachers upload notes visible to all students.

🧠 Flashcards — Student-created, private, and persistent revision cards.

🤖 AI Mentor — Personalized guidance on what to learn next and why.

🧭 Career Guidance — AI-driven career recommendations and learning roadmaps.

👤 Guest Demo Mode — Limited access for judges without signup.


🎮 Learning Games (Highlights)

  • Error Detection Game – Identify incorrect steps or statements
  • Arrange the Steps – Sequence-based problem solving
  • Missing Piece Game – Contextual fill-the-gap learning
  • Correct vs Incorrect – Fast misconception detection
  • Space Quiz Game – Time-based visual quiz experience
  • Save the Rabbit – Classification game with visual cause–effect

💡 Each game includes hints, explanations, and supports Practice, Game, and Challenge modes.


🤖 AI Agent Architecture

SkillQuest uses multiple AI agents working together:

  • Skill Profiling Agent → Analyzes accuracy, speed, and consistency
  • Learning Path Agent → Suggests next subjects, games, and difficulty levels
  • Career Matching Agent → Maps skills and interests to suitable career paths
  • Guidance Agent → Provides ongoing personalized mentoring and roadmaps

AI-generated questions are added daily and validated against subject and difficulty constraints.


🧠 System Architecture

SkillQuest follows a role-based, AI-assisted architecture with Firebase as the backend platform.

  • Frontend → React (UI, state management, game logic)
  • Backend → Firebase Firestore (data storage & realtime updates)
  • Authentication → Firebase Auth (Email/Password)
  • AI Services → AI agents (abstracted via service layer)
  • Hosting → Firebase Hosting

🧰 Tech Stack

React TypeScript Firebase CSS

Frontend

  • React
  • TypeScript
  • Phaser.js (Game Engine)
  • CSS / Tailwind

Backend & Services

  • Firebase Authentication
  • Firebase Firestore
  • Firebase Hosting

AI

  • Custom AI agents (learning analysis & career guidance)

🔐 Security & Access Control

Strict role-based access is enforced at both UI and backend levels.

  • Students can access learning, notes, analytics, and AI mentor
  • Teachers can upload and delete only their own notes
  • Guest users have limited demo access with no data persistence
  • Firestore rules ensure user data privacy and ownership

⚠️ Email IDs and secret keys shown in examples are for demonstration only.
The actual system validates format and authorization rules, not hardcoded values.


🚀 Future Enhancements

SkillQuest is designed with scalability in mind. The following enhancements are planned to further improve personalization, conceptual clarity, and curriculum alignment.

1. 🎓 Class & Topic–Based Learning Flow

Current Flow : Select Subject → Mode & Difficulty → Select Game

Planned Flow : Select Subject → Select Class (1–12) → Select Topic → Mode & Difficulty → Select Game

Questions will be dynamically generated based on the selected subject, class, topic, game type, learning mode, and difficulty level, ensuring syllabus-aligned and age-appropriate learning.

2. 🎮 Expanded Game Library

  • Introduction of additional concept-based learning games.

  • Games will focus on:

    • Deep conceptual understanding
    • Logical reasoning
    • Application-based problem solving
  • Each new game will support:

    • Practice Mode
    • Game Mode
    • Challenge Mode

This expansion will allow students to understand the same concept through multiple cognitive approaches, improving retention and learning depth.

3. 📚 Class-Based Notes Filtering

  • Teachers will be able to assign a class level to uploaded notes.
  • Students will be able to filter notes by class in the Notes section.
  • This ensures:
    • Reduced information overload
    • Faster access to relevant study material
    • Better curriculum alignment

These enhancements will strengthen SkillQuest’s vision of becoming a complete, curriculum-aware, AI-powered learning ecosystem.


🧠 What We Learned

Building SkillQuest during DUHacks 5.0 helped us gain hands-on experience in:

• Designing gamified learning systems
• Implementing role-based authentication
• Managing persistent user data
• Building AI-driven personalization logic
• Translating educational psychology into product design
• Structuring scalable frontend and backend logic


👥 Team

Built with passion by:

Subham Kolay
Trishit Majumdar
Subhadeep Shome
Soumyadeep Saha

Hooghly Engineering And Technology College
BTech - Computer Science.


⭐ Support

If you find SkillQuest useful or inspiring, consider giving this repository a ⭐ — it motivates us to keep building!


About

SkillQuest is an AI-powered learning platform that helps students master subjects through interactive educational games, personalized AI mentoring, progress tracking, achievements, and consistency-based learning—making education engaging, adaptive, and stress-free.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors