| name | gamification |
| version | 1.1.0 |
| description | XP system for productivity gamification via ClawdBot - track levels, badges, streaks, and achievements |
| author | ClawdBot |
| category | productivity |
| tags | ["gamification","xp","levels","badges","streaks","habits","productivity","motivation","achievements","goals"] |
| env | [{"name":"SUPABASE_URL","description":"Supabase project URL for gamification data storage","required":true},{"name":"SUPABASE_SERVICE_KEY","description":"Supabase service role key for database access","required":true}] |
| keywords | ["earn xp","level up","streak bonus","habit tracking","goal milestones","leaderboard","accountability"] |
| triggers | ["my xp","what level am I","my badges","leaderboard","xp stats","gamification stats"] |
Gamification & XP System
Turn productivity into a game with XP, levels, badges, streaks, and achievements. Every completed task, habit, and goal milestone earns XP toward leveling up.
ClawdBot Integration
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.
Features
- XP System: Earn XP for habits, tasks, and goal milestones
- Leveling: Level up with formula
XP = 50 * (level^2)
- Streak Bonuses: Up to 2.0x multiplier for consistent habits
- Badges: Earn badges for achievements and milestones
- Leaderboard: Compare progress (multi-user support)
- Accountability: Track commitment and earn-back system
Environment Variables
| Variable | Required | Description |
|---|
SUPABASE_URL | Yes | Supabase project URL |
SUPABASE_SERVICE_KEY | Yes | Supabase service role key |
API Endpoints
All endpoints are relative to the ClawdBot API server ({CLAWDBOT_API_URL}/api/gamification/).
Get User Stats
GET /api/gamification/stats/:userId
Response:
{
"totalXp": 2450,
"currentLevel": 7,
"weeklyXp": 350