Skip to content
RandomJainamPublic

About

No description, website, or topics provided.

Resources

Security policy

Stars

1 star

Watchers

0 watching

Forks

Latest commit

 

History

1 Commit

Folders and files

Repository files navigation

SkillEx V2 — The AI-Guided Peer Learning Network

AI helps you understand WHAT to learn, HOW to learn it, and WHO to learn/practice with. Humans provide the conversation, code reviews, design critique, and perspective AI cannot replace.


🚀 Product North Star & Core Loop

ONBOARD
→ UNDERSTAND USER & PASSPORT
→ DISCOVERY HUB
→ PERSONALIZED AI 7-DAY LEARNING PLAN
→ DAILY 30-MIN STUDY WINDOW (WITH AI MENTOR)
→ POLICY-DRIVEN MATCHING ENGINE
→ CONNECTION REQUEST & ACCEPTANCE
→ REALTIME PRIVATE CHAT
→ CANONICAL PEER SESSION (FEEDBACK / CONVERSATION)
→ OUTCOME RATING (YES / SOMEWHAT / NO)
→ PEER REVIEW & REPUTATION

🎯 The Three Curated Hackathon Domains

SkillEx V2 demonstrates a broad relational data model with configuration-driven behavior:

  1. Technology & Engineering (React, Python, Web Dev, Git/GitHub):
    • Pedagogy Template: CONCEPT_PRACTICE_CHECK (Concept → Code Pattern → Exercise → Check)
    • Session Template: FEEDBACK (GitHub Pull Request & Architecture Review)
  2. Design & Visual Craft (UI/UX Design, Figma, Visual Design, Portfolio):
    • Pedagogy Template: DESIGN_TASK_CRITIQUE (Heuristic → Creation Challenge → Checklist → Revise)
    • Session Template: FEEDBACK (Figma Auto-Layout & Component Spec Critique)
  3. Language & Fluency (English, Hindi, Japanese):
    • Pedagogy Template: PROMPT_PRACTICE_FEEDBACK (Context → Speaking Prompt → Nuance)
    • Session Template: CONVERSATION (1-on-1 Structured Dialogue)

👥 Demo Personas & Instant Switcher

SkillEx V2 comes with pre-seeded personas across all 3 domains, selectable directly from the top navigation bar:

Persona Primary Focus Can Share Wants to Learn / Practice
Aarav Sharma Frontend Engineer React (Expert) Spoken English (Intermediate) & UI/UX
Maya Lin Product Design Lead Figma & UI/UX (Expert) React Component Code (Beginner)
Elena Rostova Communications Lead English (Expert) Conversational Hindi (Beginner)
Kenji Sato Backend Architect Python (Expert), Japanese (Native) Business English (Intermediate)
Priya Patel Fullstack Developer React (Advanced) Portfolio Design (Intermediate)

🛠️ Architecture & Tech Stack

  • Frontend: Next.js 14 (App Router) + TypeScript + Tailwind CSS + Lucide Icons
  • Database & Storage: PostgreSQL / Supabase with Row Level Security (RLS)
  • AI Gateway: Server-side Gateway (OpenRouter with Zod schema validation & fallback pedagogy engine)
  • Matching Engine: Deterministic policy engine (R1–R10) with explainable reasoning bullets
  • Testing: Vitest automated test suite (npm test) with 100% passing state machine and policy tests

🏃 Local Setup & Run Commands (Windows PowerShell)

# 1. Install dependencies
npm.cmd install

# 2. Copy environment template
Copy-Item .env.example .env.local

# 3. Run automated tests (Unit, E2E, Adversarial Security)
npm.cmd test

# 4. Start local development server
npm.cmd run dev

# 5. Compile optimized production build
npm.cmd run build

# 6. Start production server locally
npm.cmd run start

Open http://localhost:3000 to enter SkillEx V2.


🧪 Integration Verification Commands

Verify Automated Test Suite (19 Tests)

npm.cmd test

Verify AI Gateway & Learning Plan Generation (HTTP API)

Invoke-RestMethod -Uri "http://localhost:3000/api/learning/plan" -Method POST -ContentType "application/json" -Body '{"skillId":"tech-react","currentLevel":"BEGINNER","targetGoal":"Master React state and hooks in 7 days","hoursPerDay":1}'

Verify Deterministic Matching Engine (HTTP API)

Invoke-RestMethod -Uri "http://localhost:3000/api/matching?userId=user-aarav-101" -Method GET

📚 Technical Documents

About

No description, website, or topics provided.

Resources

Security policy

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages