MCPcopy Index your code
hub / github.com/PrakashRaj-sjce/skillConnectAI

github.com/PrakashRaj-sjce/skillConnectAI @main

Chat with this repo
repository ↗ · DeepWiki ↗ · + Follow
157 symbols 518 edges 79 files 0 documented · 0%
What it actually does AI analysis from the code graph — generated when you open this
loading…
README

SkillConnect AI - Complete Career Intelligence Platform 🚀

A comprehensive AI-powered career guidance platform that helps students and professionals transform their careers with personalized roadmaps, skill analysis, resume parsing, job matching, and expert AI guidance.

🌟 Features

📄 Resume Upload & Parsing

  • Bulk PDF Upload: Process multiple resumes simultaneously
  • AI-Powered Extraction: Extract names, contact info, skills, experience, and education
  • Skill Categorization: Automatically categorize technical and soft skills
  • Data Validation: Ensure data quality and completeness

🤖 AI Career Chatbot

  • Personalized Guidance: Career advice based on individual profiles
  • Course Recommendations: Curated courses from Coursera, Udemy, YouTube, freeCodeCamp
  • Interview Preparation: Technical and behavioral interview strategies
  • Learning Roadmaps: Step-by-step career development plans
  • Real-time Responses: Intelligent fallback system for reliable assistance

🏢 Job Requirements Management

  • Company Job Postings: Upload and manage job requirements
  • Skill Requirements: Define required technical and soft skills
  • Experience Levels: Specify experience requirements
  • Bulk Management: Handle multiple job postings efficiently

🎯 Smart Resume-Job Matching

  • Advanced Algorithm: Multi-criteria matching with weighted scoring
  • Compatibility Analysis: Skills, experience, education, and project relevance
  • Match Scoring: Detailed percentage-based compatibility scores
  • Recommendations: AI-powered hiring recommendations
  • Gap Analysis: Identify missing skills and improvement areas

📊 Skill Gap Analysis

  • Market Intelligence: Analyze skill demand vs. supply
  • Visual Analytics: Interactive charts and progress tracking
  • Trend Analysis: Identify emerging skill requirements
  • Training Recommendations: Suggest upskilling opportunities
  • Experience Distribution: Understand candidate experience levels

🗺️ Learning Roadmaps

  • Personalized Paths: Custom roadmaps based on current skills and target roles
  • Course Integration: Direct links to courses on major platforms
  • Progress Tracking: Monitor learning progress and milestones
  • Resource Curation: Handpicked courses, articles, and practice materials
  • Difficulty Progression: Structured learning from beginner to advanced

🛠️ Tech Stack

  • Frontend: Next.js 14, React, TypeScript, TailwindCSS
  • UI Components: shadcn/ui with custom styling
  • Backend: Next.js API Routes, Server Actions
  • AI Integration: OpenAI GPT-4 with intelligent fallbacks
  • Database: Mock data (easily replaceable with MongoDB/PostgreSQL)
  • Deployment: Vercel-ready with environment variable support

🚀 Getting Started

Prerequisites

  • Node.js 18+
  • npm or yarn
  • OpenAI API key (optional - platform works with fallbacks)

Installation

  1. Clone the repository ```bash git clone https://github.com/yourusername/skillconnect-ai.git cd skillconnect-ai ```

  2. Install dependencies ```bash npm install ```

  3. Set up environment variables Create a .env.local file: ```env # Optional - Platform works with intelligent fallbacks OPENAI_API_KEY=your_openai_api_key_here

# Optional future integrations DATABASE_URL=your_database_url_here SENDGRID_API_KEY=your_sendgrid_key_here ```

  1. Run the development server ```bash npm run dev ```

  2. Open your browser Navigate to http://localhost:3000

📱 Platform Walkthrough

1. Home Dashboard

  • Overview of platform capabilities
  • Quick access to all major features
  • Statistics and analytics summary
  • Navigation to specialized modules

2. Resume Upload & Processing

  • Drag-and-drop PDF upload interface
  • Real-time processing with progress tracking
  • Detailed extraction results with validation
  • Bulk processing capabilities

3. AI Career Assistant

  • Interactive chat interface with conversation history
  • Context-aware responses based on user profiles
  • Course recommendations with direct links
  • Quick question templates for common queries

4. Job Requirements Management

  • Form-based job posting creation
  • Skill requirement specification
  • Company and role information management
  • Saved job postings with easy editing

5. Smart Matching Engine

  • Comprehensive compatibility analysis
  • Visual match scoring with detailed breakdowns
  • Skills gap identification and recommendations
  • Hiring decision support with AI insights

6. Skill Analytics Dashboard

  • Market demand vs. candidate supply analysis
  • Interactive skill distribution charts
  • Experience level breakdowns
  • Training and development recommendations

7. Learning Roadmap Generator

  • Personalized career path creation
  • Progress tracking with milestone management
  • Resource integration from multiple platforms
  • Adaptive learning recommendations

🎯 Use Cases

For Educational Institutions

  • Student Career Guidance: Help students understand career paths
  • Curriculum Planning: Align courses with industry demands
  • Placement Preparation: Prepare students for campus interviews
  • Skill Gap Analysis: Identify areas for curriculum improvement

For Recruiters & HR

  • Resume Screening: Automate initial candidate screening
  • Skill Matching: Find best-fit candidates for specific roles
  • Talent Pipeline: Build and manage candidate databases
  • Hiring Analytics: Make data-driven hiring decisions

For Career Counselors

  • Personalized Guidance: Provide tailored career advice
  • Learning Path Creation: Design custom development plans
  • Progress Monitoring: Track student/client progress
  • Resource Curation: Maintain updated learning resources

For Students & Professionals

  • Career Planning: Understand required skills for target roles
  • Skill Development: Get personalized learning recommendations
  • Interview Preparation: Practice with AI-powered guidance
  • Progress Tracking: Monitor career development journey

🔧 Advanced Features

AI-Powered Resume Analysis

```javascript // Advanced parsing with skill extraction const resumeAnalysis = { personalInfo: extractPersonalDetails(resumeText), technicalSkills: categorizeSkills(extractedSkills), experience: parseExperience(resumeText), projects: identifyProjects(resumeText), education: extractEducation(resumeText) } ```

Smart Matching Algorithm

```javascript // Multi-criteria matching with weighted scoring const matchScore = calculateMatch({ skillsWeight: 0.4, // 40% - Technical skills alignment experienceWeight: 0.25, // 25% - Experience level match educationWeight: 0.15, // 15% - Educational background projectsWeight: 0.15, // 15% - Project relevance softSkillsWeight: 0.05 // 5% - Soft skills compatibility }) ```

Intelligent Course Recommendations

```javascript // Context-aware course suggestions const courseRecommendations = generateCourses({ currentSkills: userProfile.skills, targetRole: userGoals.role, learningStyle: userPreferences.style, timeAvailable: userConstraints.time, platforms: ['Coursera', 'Udemy', 'YouTube', 'freeCodeCamp'] }) ```

🔒 Security & Privacy

  • Data Protection: Secure handling of personal information
  • API Security: Protected endpoints with validation
  • Privacy Compliance: GDPR-ready data handling
  • Secure Storage: Encrypted data storage options
  • Access Control: Role-based access management

📈 Analytics & Insights

Platform Metrics

  • Total resumes processed
  • Successful job matches
  • Average compatibility scores
  • Popular skill trends
  • Learning completion rates

User Analytics

  • Individual progress tracking
  • Skill development timelines
  • Course completion rates
  • Career milestone achievements
  • Personalized recommendations

🌐 Deployment

Vercel Deployment (Recommended)

  1. Connect to Vercel ```bash npm i -g vercel vercel ```

  2. Set Environment Variables

  3. Add OPENAI_API_KEY in Vercel dashboard (optional)
  4. Configure other environment variables as needed

  5. Deploy ```bash vercel --prod ```

Docker Deployment

```dockerfile FROM node:18-alpine WORKDIR /app COPY package*.json ./ RUN npm install COPY . . RUN npm run build EXPOSE 3000 CMD ["npm", "start"] ```

🤝 Contributing

We welcome contributions! Please see our Contributing Guidelines for details.

Development Setup

  1. Fork the repository
  2. Create a feature branch (git checkout -b feature/amazing-feature)
  3. Commit your changes (git commit -m 'Add amazing feature')
  4. Push to the branch (git push origin feature/amazing-feature)
  5. Open a Pull Request

Code Standards

  • TypeScript for type safety
  • ESLint and Prettier for code formatting
  • Comprehensive error handling
  • Responsive design principles
  • Accessibility best practices

📚 API Documentation

Resume Upload

```typescript POST /api/upload-resume Content-Type: multipart/form-data

Response: { success: boolean, data: ResumeData, message: string } ```

AI Chat

```typescript POST /api/chat Content-Type: application/json

Body: { message: string, context: UserContext }

Response: { response: string, suggestions?: string[], courses?: Course[] } ```

Job Matching

```typescript GET /api/matches Query: { candidateId?: string, jobId?: string, minScore?: number }

Response: { matches: Match[], analytics: MatchAnalytics } ```

🎓 Educational Impact

Learning Outcomes

  • Career Clarity: Students gain clear understanding of career paths
  • Skill Awareness: Identification of required vs. current skills
  • Learning Efficiency: Optimized learning paths reduce time to competency
  • Industry Alignment: Better preparation for industry requirements

Institutional Benefits

  • Placement Rates: Improved student placement statistics
  • Curriculum Relevance: Data-driven curriculum updates
  • Industry Partnerships: Better alignment with industry needs
  • Student Satisfaction: Enhanced career guidance services

🔮 Future Enhancements

Planned Features

  • Video Interview Analysis: AI-powered interview feedback
  • Salary Insights: Market-based compensation analysis
  • Networking Recommendations: Professional connection suggestions
  • Mobile Application: Native iOS and Android apps
  • Integration APIs: Connect with existing HR systems

Advanced AI Features

  • Predictive Analytics: Career success probability modeling
  • Personalized Learning: Adaptive learning path optimization
  • Market Intelligence: Real-time job market analysis
  • Skill Trend Prediction: Emerging skill identification

📞 Support & Community

Getting Help

  • Documentation: Comprehensive guides and tutorials
  • Community Forum: Connect with other users
  • Issue Tracking: GitHub issues for bug reports
  • Feature Requests: Suggest new features and improvements

Contact

🙏 Acknowledgments

  • OpenAI for providing powerful AI models
  • Vercel for hosting and deployment platform
  • shadcn/ui for beautiful UI components
  • Next.js team for the amazing framework
  • Open Source Community for inspiration and contributions

Built with ❤️ for the future of career development

SkillConnect AI - Empowering careers through intelligent technology

🚀 Quick Start Commands

```bash

Install dependencies

npm install

Start development server

npm run dev

Build for production

npm run build

Start production server

npm start

Run linting

npm run lint

Run type checking

npm run type-check ```

Ready to transform career guidance with AI? Get started today! 🌟

Extension points exported contracts — how you extend this code

Message (Interface)
(no doc)
components/chat-bot.tsx
State (Interface)
(no doc)
components/ui/use-toast.ts
ResumeData (Interface)
(no doc)
app/page.tsx
ResumeData (Interface)
(no doc)
app/chatbot/page.tsx
LeaderboardEntry (Interface)
(no doc)
app/leaderboard/page.tsx
JobRequirement (Interface)
(no doc)
app/job-requirements/page.tsx
ResumeData (Interface)
(no doc)
app/matches/page.tsx
ResumeData (Interface)
(no doc)
app/skill-analysis/page.tsx

Core symbols most depended-on inside this repo

cn
called by 223
lib/utils.ts
toast
called by 8
hooks/use-toast.ts
handleInputChange
called by 7
app/job-requirements/page.tsx
dispatch
called by 5
components/ui/use-toast.ts
dispatch
called by 5
hooks/use-toast.ts
useCarousel
called by 4
components/ui/carousel.tsx
useSidebar
called by 4
components/ui/sidebar.tsx
useFormField
called by 4
components/ui/form.tsx

Shape

Function 128
Interface 29

Languages

TypeScript100%

Modules by API surface

app/job-requirements/page.tsx14 symbols
app/chatbot/page.tsx10 symbols
hooks/use-toast.ts9 symbols
components/ui/use-toast.ts9 symbols
components/chat-bot.tsx9 symbols
app/dashboard/page.tsx9 symbols
app/skill-analysis/page.tsx8 symbols
app/roadmaps/page.tsx8 symbols
app/matches/page.tsx7 symbols
app/upload-resumes/page.tsx6 symbols
components/ui/pagination.tsx5 symbols
app/page.tsx5 symbols

For agents

$ claude mcp add skillConnectAI \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact