ClawKit Logo
ClawKitReliability Toolkit
Back to Registry
Official Verified

gamification

XP system for productivity gamification via ClawdBot - track levels, badges, streaks, and achievements

skill-install — Terminal

Install via CLI (Recommended)

clawhub install openclaw/skills/skills/chipagosfinest/gamification-xp
Or

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

VariableRequiredDescription
SUPABASE_URLYesSupabase project URL
SUPABASE_SERVICE_KEYYesSupabase 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,
  "monthlyXp": 1200,
  "progress": {
    "xpInLevel": 150,
    "xpNeeded": 450,
    "percent": 33
  },
  "accountability": {
    "balance": 50,
    "totalSlashed": 10,
    "totalEarnedBack": 60
  }
}

Get Recent Transactions

GET /api/gamification/transactions/:userId?limit=20

Get User Badges

GET /api/gamification/badges/:userId

Award XP (Internal)

POST /api/gamification/award
{
  "userId": "302137836",
  "amount": 50,
  "source": "habit",
  "sourceId": "morning-routine",
  "note": "Completed morning routine"
}

Complete Habit (with streak bonus)

POST /api/gamification/habit-complete
{
  "userId": "302137836",
  "habitId": "workout",
  "currentStreak": 7
}

Complete Task

POST /api/gamification/task-complete
{
  "userId": "302137836",
  "taskId": "task-123",
  "priority": 8
}

Goal Milestone

POST /api/gamification/goal-milestone
{
  "userId": "302137836",
  "goalId": "goal-456",
  "milestonePercent": 50
}

Award Badge

POST /api/gamification/badge
{
  "userId": "302137836",
  "badgeType": "early_bird",
  "metadata": { "streak": 30 }
}

Get Leaderboard

GET /api/gamification/leaderboard

Get XP Config

GET /api/gamification/config

Database Tables

This skill requires the following Supabase tables:

  • user_gamification - User XP totals, levels, streaks
  • xp_transactions - XP award history
  • user_badges - Earned badges

XP Rewards

Read Full Documentation on GitHub

Metadata

Author@chipagosfinest
Stars2387
Views0
Updated2026-03-09
View Author Profile
AI Skill Finder

Not sure this is the right skill?

Describe what you want to build — we'll match you to the best skill from 16,000+ options.

Find the right skill
Add to Configuration

Paste this into your clawhub.json to enable this plugin.

{
  "plugins": {
    "official-chipagosfinest-gamification-xp": {
      "enabled": true,
      "auto_update": true
    }
  }
}

Tags

#gamification#xp#levels#badges#streaks#habits#productivity#motivation#achievements#goals
Safety NoteClawKit audits metadata but not runtime behavior. Use with caution.

Related Skills

solopreneur-assistant

AI Chief of Staff for solo businesses — inbox triage, task prioritization, revenue tracking, decision journals, opportunity scoring, and weekly reviews.

clawdssen 2387

Meeting Brief Copilot

Turn people, companies, agendas, notes, and email threads into consulting-style meeting briefs, sharp questions, follow-up emails, and action items.

atwatcher 2387

daily-report-generator

Automatically generate daily/weekly work reports from git commits, calendar events, and task lists. Use when you need to quickly create professional work reports without manual effort.

1989tianlong 2387

linear-todos

A CLI tool that executes Python source code to manage todos via Linear's API. Creates tasks with natural language dates, priorities, and scheduling. This is a source-execution skill - code in src/linear_todos/ runs when commands are invoked.

avegancafe 2387

writing-assistant

AI writing partner for solopreneurs and content creators. Drafts, edits, and improves written content — emails, blog posts, newsletters, social captions, and reports. Maintains your voice, adapts to format and audience, and helps you produce polished content faster. Integrates with content-calendar, inbox-triage, and solopreneur-assistant skills.

clawdssen 2387