XP system for productivity gamification via ClawdBot - track levels, badges, streaks, and achievements
Turn productivity into a game with XP, levels, badges, streaks, and achievements. Every completed task, habit, and goal milestone earns XP toward leveling up.
This skill is designed for ClawdBot - it provides the prompt interface for ClawdBot's gamification API server which stores data in Supabase.
Architecture:
User → ClawdBot Gateway → ClawdBot API Server → Supabase (Postgres)
(Railway) (user_gamification, xp_transactions tables)
The backend implementation lives in api-server/src/routes/gamification.ts and api-server/src/lib/xp-engine.ts.
XP = 50 * (level^2)| Variable | Required | Description |
|---|---|---|
SUPABASE_URL | Yes | Supabase project URL |
SUPABASE_SERVICE_KEY | Yes | Supabase service role key |
All endpoints are relative to the ClawdBot API server ({CLAWDBOT_API_URL}/api/gamification/).
GET /api/gamification/stats/:userId
Response:
{
"totalXp": 2450,
"currentLevel": 7,
"weeklyXp": 350,
"monthlyXp": 1200,
"progress": {
"xpInLevel": 150,
"xpNeeded": 450,
"percent": 33
},
"accountability": {
"balance": 50,
"totalSlashed": 10,
"totalEarnedBack": 60
}
}
GET /api/gamification/transactions/:userId?limit=20
GET /api/gamification/badges/:userId
POST /api/gamification/award
{
"userId": "302137836",
"amount": 50,
"source": "habit",
"sourceId": "morning-routine",
"note": "Completed morning routine"
}
POST /api/gamification/habit-complete
{
"userId": "302137836",
"habitId": "workout",
"currentStreak": 7
}
POST /api/gamification/task-complete
{
"userId": "302137836",
"taskId": "task-123",
"priority": 8
}
POST /api/gamification/goal-milestone
{
"userId": "302137836",
"goalId": "goal-456",
"milestonePercent": 50
}
POST /api/gamification/badge
{
"userId": "302137836",
"badgeType": "early_bird",
"metadata": { "streak": 30 }
}
GET /api/gamification/leaderboard
GET /api/gamification/config
This skill requires the following Supabase tables:
user_gamification - User XP totals, levels, streaksxp_transactions - XP award historyuser_badges - Earned badges| Action | Base XP | Notes |
|---|---|---|
| Habit completion | 10-50 | + streak bonus up to 2x |
| Task completion | 5-50 | Based on priority (1-10) |
| Goal 25% milestone | 100 | First quarter |
| Goal 50% milestone | 200 | Halfway |
| Goal 75% milestone | 300 | Three quarters |
| Goal 100% completion | 500 | Full completion |
"What's my XP level?"
"How close am I to leveling up?"
"Show my gamification stats"
"What badges do I have?"
"Show my recent XP transactions"
"What's my current streak?"
"Show the leaderboard"
"Who has the most XP?"
goals - Set and track goalshabits - Habit tracking systemremind - Reminder systemdaily-briefing - Daily progress summary