Skip to content

Repository files navigation

⚡ Skill Gap — AI Career Intelligence Platform

Discover your skill gaps, get career matches, and land your dream role with AI guidance.

Next.js Tailwind Groq License


🎯 Problem Statement

75% of resumes never reach a human recruiter due to ATS rejection. Students graduate without knowing which skills they're missing for their dream career. There is no single platform that combines skill assessment, career matching, resume analysis, and AI coaching.

Skill Gap solves all of this in one place.


✨ Features

🧠 Smart Assessment

  • Rate 200+ in-demand skills with proficiency levels (Beginner → Expert)
  • 7-dimension aptitude evaluation with descriptions
  • 3-step guided wizard with keyboard navigation
  • AI Skill Analysis powered by Groq LLaMA 3.3 70B
  • Smart warnings for insufficient skills
  • Autocomplete search with 200+ skills database

🎯 Career Match Engine

  • AI-powered matching against 15+ career profiles
  • Weighted scoring based on skill proficiency levels
  • Shows exact missing skills per career
  • Bar chart + Radar chart visualization (Recharts)
  • Fallback local scorer if AI unavailable

🤖 AI Career Coach

  • Powered by Groq LLaMA 3.3 70B (ultra fast)
  • Personalized advice based on your career results
  • Quick question suggestions
  • Real-time chat interface
  • Accessible directly from navbar

📄 Resume Analyzer

  • Upload PDF or DOCX (max 10MB)
  • Drag and drop interface
  • Real AI-powered ATS scoring (0-100)
  • Skills, education, certification extraction
  • 5 specific improvement suggestions with point gains
  • 4 career matches based on actual resume content
  • Powered by Groq LLaMA 3.3 70B + pdf-parse

🛠 Tech Stack

Layer Technology
Frontend Next.js 14, Tailwind CSS
State Management Zustand
Charts Recharts (Bar + Radar)
Auth NextAuth + Google OAuth
AI Chat Groq LLaMA 3.3 70B
AI Resume Groq LLaMA 3.3 70B
PDF Parsing pdf-parse + mammoth
Deployment Vercel

🗺️ Project Workflow

View Flowchart


🚀 Getting Started

Prerequisites

  • Node.js 18+
  • npm 9+
  • Groq API Key (free at console.groq.com)
  • Google OAuth Credentials

Installation

# Clone the repo
git clone https://github.com/YOURNAME/skillgap.git

# Go into project
cd skillgap/skillgap

# Install dependencies
npm install

# Create environment file
cp .env.example .env.local

Environment Variables

Create .env.local with:

GOOGLE_CLIENT_ID=your_google_client_id
GOOGLE_CLIENT_SECRET=your_google_client_secret
NEXTAUTH_SECRET=your_random_secret
NEXTAUTH_URL=http://localhost:3000
GROQ_API_KEY=your_groq_api_key

Run Development Server

npm run dev

Run Locally

(http://localhost:3000)

Live Demo

📁 Project Structure

skillgap/
├── app/
│   ├── page.jsx              # Landing page
│   ├── login/                # Google OAuth login
│   ├── dashboard/            # User dashboard
│   ├── assessment/           # 3-step assessment wizard
│   ├── results/              # Career match results + AI coach
│   ├── resume/               # Resume analyzer
│   └── api/
│       ├── auth/             # NextAuth Google OAuth
│       ├── chat/             # Groq AI career coach + skill analysis
│       └── resume/           # Groq resume analyzer endpoint
├── components/
│   ├── ui/                   # Navbar, Providers
│   └── layout/               # Layout components
├── store/
│   └── appStore.js           # Zustand global state
├── constants/
│   ├── skills.js         # 200+ skills database
│   └── careers.js        # Career profiles
└── lib/
    └── scorer.js         # Career matching algorithm

🤖 AI Features

Feature Model Description
Skill Analysis Groq LLaMA 3.3 70B Analyzes skills → suggests careers
Career Matching Groq LLaMA 3.3 70B AI-powered compatibility scores
Career Coach Groq LLaMA 3.3 70B Personalized career advice chat
Resume Analyzer Groq LLaMA 3.3 70B ATS scoring + improvement tips

🗺 Roadmap

  • Smart career assessment ✅
  • Skill proficiency levels ✅
  • AI-powered career matching ✅
  • AI Career Coach (Groq) ✅
  • Real AI resume analyzer ✅
  • Google OAuth login ✅
  • AI skill analysis in assessment ✅
  • Database integration
  • LinkedIn profile import
  • Learning resource recommendations
  • Progress tracking over time
  • Mobile app (React Native)
  • Company job matching

📄 License

MIT License — feel free to use and modify.


Built for students, by students. ⚡

About

AI-powered career intelligence platform for students. Discover your skill gaps, get career matches, and land your dream role with Groq LLaMA 3.3 70B guidance.

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages