convez.ai
Skill
akkyyakhilesh

SkillKite

akkyyakhilesh/SkillKite

Ver no GitHub
InicialPluginScore · de 0 a 100

AI career coach for Tier 2/3 India students. WhatsApp + Claude + .NET 8.

Instalação

$npx convez-ai akkyyakhilesh/SkillKite

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
1
Forks
0
Acompanhando
0
Saúde
42%
Último commit
há 5 meses
Versão
—
Issues abertas
0
Contribuidores
1

README

A tradução para o português deste README ainda está na fila.

SkillKite

Right skills. Higher reach. 🪁 A free AI career coach on WhatsApp for Tier 2/3 India.

CI Live site .NET 8 Claude PostgreSQL License: MIT


What it does

You message a WhatsApp number. The bot asks where you are in your journey and routes you to one of four flows:

FlowForOutput
📚 10th ke baadJust finished class 103-4 page PDF covering every stream (PCM/PCB/Commerce/Arts), plus polytechnic + paramedical diploma options
🎯 12th ke baadJust finished class 12Stream-specific PDF (B.Tech / MBBS / CA / BA LLB / etc.) with entrance exams + realistic salary bands
💼 Career roadmapDegree done / final year~10-question assessment in Hinglish → 3 best-fit career suggestions → personalized 12–24 week roadmap PDF with free YouTube + NPTEL resources
🌱 Skill upgradeAlready working(in build)

Everything is in Hinglish, tappable buttons over typing, and delivered as a bilingual PDF in the same WhatsApp chat. End-to-end in ~5 minutes.

Built for students in places like Bhagalpur, Purnea, Muzaffarpur, Darbhanga — where career counselors charge ₹5,000+ and metro mentors don't reach.

Why it exists

90% of India's students live outside major metros. They have the same degrees as their Bangalore peers but wildly different access to career guidance, mentorship, and exposure. SkillKite is a single founder's attempt to close that gap with the one thing every student already has: a WhatsApp chat window.

Long-form thesis available on request — DM me on LinkedIn or open an issue.

Try it

  • 📱 WhatsApp the bot: +91 62012 26351 — no signup, no whitelist, no early-access gate
  • 🪁 Landing page: skillkite.in → tap the green "Chat on WhatsApp" button
  • 🌐 API: bot.skillkite.in/api/healthz

Architecture

┌─────────────────┐     ┌──────────────────────┐     ┌─────────────┐
│  WhatsApp       │ →   │  .NET 8 Web API      │ →   │  Claude     │
│  Cloud API      │     │  (clean architecture) │     │  Sonnet     │
└─────────────────┘     │                       │     └─────────────┘
                        │  ┌─────────────────┐ │
┌─────────────────┐     │  │ Orchestrator   │ │     ┌─────────────┐
│  Angular PWA    │ →   │  │ Career Engine  │ │ →   │ PostgreSQL  │
│  (Phase 2)      │     │  │ PDF Generator  │ │     │ (jsonb)     │
└─────────────────┘     │  └─────────────────┘ │     └─────────────┘
                        └──────────────────────┘

Clean architecture, 5 projects:

ProjectPurpose
SkillKite.CoreDomain models, enums, DTOs, interfaces — zero infrastructure dependencies
SkillKite.DataAppDbContext, EF Core migrations, career-path seed
SkillKite.InfrastructureClaudeCareerEngine, WhatsAppService, RoadmapPdfGenerator, AssessmentOrchestrator, CareerPathRepository
SkillKite.APIASP.NET Core controllers (Webhook, Chat, Roadmap, Progress, Careers, Health) + signature-validation middleware
SkillKite.TestsxUnit — payload parsing, HMAC verification

The API is frontend-agnostic: WhatsApp today, Angular PWA tomorrow (Phase 2), Capacitor Android app (Phase 3) — same orchestrator, no rewrite.

Tech stack

LayerChoiceWhy
Web framework.NET 8Strong typing + perf, fits founder's stack experience
AI engineClaude Sonnet (Anthropic)Best Hinglish reasoning + JSON output reliability
DatabasePostgreSQL + Npgsqljsonb for flexible assessment data; cheap to host
MessagingWhatsApp Cloud APIZero-friction reach for Tier 2/3 users
PDFQuestPDF + Noto Sans DevanagariClean bilingual rendering
Tunnel (dev)Cloudflare TunnelPermanent bot.skillkite.in URL, no laptop port forwarding
LandingVanilla HTML/CSS/JS on Cloudflare PagesSub-500 ms load on 3G; no framework bloat
AnalyticsCloudflare Web AnalyticsPrivacy-first, zero JS overhead

Endpoints (Phase 1)

GET    /api/healthz                  Liveness + DB probe
GET    /api/stats                    Aggregate counts (no PII)
GET    /api/careers                  List 27 curated career paths
GET    /api/careers/{id}             Career path detail with resources

POST   /api/chat/start               Begin an assessment session
POST   /api/chat/message             Send a message, get the reply
GET    /api/chat/session/{id}        Inspect session history

POST   /api/roadmaps/generate        Generate a roadmap for a session
GET    /api/roadmaps/{id}            Roadmap detail
GET    /api/roadmaps/{id}/pdf        Download the PDF
GET    /api/roadmaps/by-phone/{p}    All roadmaps for a student

POST   /api/progress/{roadmapId}     Log weekly progress
GET    /api/progress/{roadmapId}     Progress history

GET    /api/webhook/whatsapp         Meta verification handshake
POST   /api/webhook/whatsapp         Receive WhatsApp messages

Local setup

See RUNNING.md for the full step-by-step. Short version:

# 1. secrets
cd src/SkillKite.API
dotnet user-secrets set "Claude:ApiKey" "sk-ant-..."
dotnet user-secrets set "WhatsApp:PhoneNumberId" "..."
dotnet user-secrets set "WhatsApp:AccessToken" "..."
dotnet user-secrets set "WhatsApp:AppSecret" "..."
dotnet user-secrets set "WhatsApp:VerifyToken" "your_random_string"

# 2. Postgres
docker run -d --name skillkite-pg -e POSTGRES_PASSWORD=postgres -p 5432:5432 postgres:16

# 3. Run (auto-applies migrations, seeds 27 career paths)
dotnet run --project src/SkillKite.API

# 4. Verify
curl http://localhost:5007/api/healthz

Repository layout

SkillKite/
├── src/
│   ├── SkillKite.API/              ASP.NET Core + controllers + middleware
│   ├── SkillKite.Core/             Models, enums, interfaces, DTOs
│   ├── SkillKite.Data/             EF Core context + migrations + seed
│   └── SkillKite.Infrastructure/   Claude engine, WhatsApp service, PDF generator, orchestrator
├── tests/
│   └── SkillKite.Tests/            xUnit tests
├── site/                           Vanilla HTML landing page (Cloudflare Pages)
├── content/                        Marketing drafts (LinkedIn posts, etc.)
├── tools/                          Local-only binaries (cloudflared.exe — gitignored)
├── README.md                       This file
├── RUNNING.md                      Day-to-day dev workflow
└── SkillKite.sln

Roadmap

PhaseStatusWhat
1. WhatsApp MVP (career roadmap)✅ ShippedBot, Claude engine, 27 careers, bilingual PDFs
1.5. 10th + 12th student flows✅ Shipped4-way entry split, thin-discovery PDFs covering streams, polytechnic, paramedical, course selection
2. Skill upgrade flow🟡 Next4th entry option for working professionals — next ladder rung
3. Angular PWA⏳ PlannedInstallable web app, progress dashboard, offline cache
4. Android via Capacitor⏳ FutureNative push notifications, Play Store listing
5. Monetization⏳ FuturePremium tier (mock interviews, resume builder), college B2B
6. Scale⏳ FutureRegional languages, mentor matching, job board

Contributing

This is currently a solo project being built in public. Contributions and ideas are welcome — open an issue first to discuss anything substantial. If you're a student or you know one stuck on "what do I do next?" — just WhatsApp +91 62012 26351 and try the bot. No allowlist any more.

License

MIT — see LICENSE.

Author

Akhilesh Kumar (@akkyyakhilesh) — building SkillKite alongside a full-time job, one weekend at a time.

If this resonates and you know a small-city student who's stuck on "what do I do after my degree?" — please share the link with them. That's the entire point.

🪁 Right skills. Higher reach.

Ver o original no GitHub

Bom para

Relacionados