How prajwalparish-git/skill-scout-nexus works
Skill Scout Nexus is a placement-readiness coach with both a Streamlit app and a Next.js frontend backed by an HTTP API. Students move from resume/profile assessment through skill-gap planning, quizzes, and voice or chat practice; results inform ongoing plans and readiness views. Organization administrators provision students and review cohort progress. The graph highlights these domain stages, shared services, agent workflows, and persistence. Relationships for unsampled features are included only where the README documents them; source excerpts and the SOURCE INDEX support the remaining links.
Main entry points: journey.py Journey orchestration · services.py Application services · org_admin.py Organization portal · ui.py Streamlit experience
Components 24
User experience
- Streamlit experience
piq/ui.py - Web experience
frontend/app - HTTP API
server.py
Student journey
- Resume assessment
agents/resume_parser_agent.py - Study roadmap
agents/study_planner_agent.py - Critic-checked quiz
agents/critic_quiz_agent.py - Voice assessment
agents/voice_interview_agent.py - Interview practice
piq/agents.py - Journey orchestration
piq/journey.py - Application services
piq/services.py
AI and assessment
- Rubric evaluation
agents/rubric_evaluator_agent.py - Critic workflow
piq/graph.py - Quality checks
piq/checks.py - Question bank
piq/question_bank.py
Organizations
- Organization portal
views/org_admin.py - Account provisioning
core/org_provisioning.py - Cohort insights
piq/org_insights.py
Shared platform
- SQLite records
piq/db.py - LLM interface
piq/llm.py - AI provider routing
core/ai_router.py - Speech synthesis
core/speech_router.py - Speech transcription
core/transcribe_router.py
Other components
- Student
- Organization admin
Connections 25
- Student → Streamlit experience: uses
- Student → Web experience: uses
- Organization admin → Organization portal: manages cohort
- Web experience → HTTP API: requests data
server.py - Streamlit experience → Application services: invokes
app.py - Streamlit experience → Journey orchestration: uses
app.py - HTTP API → Application services: calls
server.py - Application services → Resume assessment: uses
piq/services.py - Journey orchestration → Resume assessment: dispatches
piq/journey.py - Journey orchestration → Study roadmap: dispatches
piq/journey.py - Journey orchestration → Critic-checked quiz: dispatches
piq/journey.py - Journey orchestration → Voice assessment: dispatches
piq/journey.py - Journey orchestration → SQLite records: persists journey
piq/journey.py - Application services → SQLite records: reads and writes
piq/services.py - Application services → Question bank: looks up questions
piq/services.py - Critic-checked quiz → Critic workflow: uses review loop
piq/graph.py - Critic workflow → Quality checks: verifies drafts
piq/graph.py - Critic workflow → SQLite records: records review
piq/graph.py - Rubric evaluation → LLM interface: requests evaluation
- LLM interface → AI provider routing: routes requests
piq/llm.py - Voice assessment → Speech synthesis: speaks questions
piq/journey.py - Voice assessment → Speech transcription: transcribes answers
- Organization portal → Account provisioning: provisions accounts
- Organization portal → Cohort insights: reviews cohort
views/org_admin.py - Organization portal → Journey orchestration: views student progress
views/org_admin.py