A seamless gamification layer that transforms routine task completion into an engaging experience with XP, levels, and achievements.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install task-quest
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install task-quest using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Task Quest?
Task Quest is an innovative Openclaw Skills extension designed to provide a zero-friction gamification layer for task management. It functions as a companion to smart-tasks, automatically tracking user progress without requiring manual input. By monitoring task completion through an AI agent, it injects motivational elements like experience points (XP), leveling systems, and performance streaks directly into the developer's workflow.
The skill is built on the philosophy of natural insertion; instead of cluttering the interface with separate notifications, game progress is appended to existing agent responses. This ensures that users remain focused on their work while receiving subtle, rewarding feedback that encourages consistency and high-performance habits.
Task Quest Use Cases
- Users seeking increased motivation and engagement for daily task management.
- Developers wanting to track productivity streaks and reach career-like milestones within their IDE.
- Teams or individuals who enjoy RPG-style progression applied to real-world technical debt and project milestones.
- Automated reporting of weekly productivity gains through gamified metrics.
How Task Quest Works
- The agent initializes the session by reading the current state from quest-state.md and cross-referencing it with active tasks.
- When a task is marked as complete, the skill calculates XP based on priority, estimated hours, and timing bonuses.
- The quest-state.md file is updated in real-time, incrementing total XP, updating streaks, and checking for level-up conditions.
- The system evaluates achievement conditions (speed, consistency, or category-based) and updates achievements.md if new goals are met.
- Success metrics are seamlessly integrated as a single-line update at the end of the agent's natural response.
- Periodic history logging archives progress into quarterly files for long-term productivity analytics.
Task Quest Setup
To integrate this skill into your environment, run the initialization script provided in the Openclaw Skills directory:
bash skills/task-quest/scripts/init-quest.sh
This command creates the necessary data structure, including quest-state.md and achievements.md. Following initialization, ensure you apply the workspace integration changes as specified in your reference documentation.
Task Quest Data Schema & Taxonomy
Task Quest organizes its data within a dedicated directory using Markdown and YAML for transparency and ease of access:
| File | Purpose | Key Data Points |
|---|---|---|
quest-state.md |
Core State | Level, XP, current streak, theme, and total tasks completed. |
achievements.md |
Milestone Tracking | List of unlocked and pending achievements with timestamps. |
history/YYYY-QN.md |
Archival Data | Quarterly summaries of XP gains and weekly completion rates. |
themes.md |
Visual Styling | Configuration for RPG, Space, Academic, or Minimalist reporting styles. |
Task Quest Advanced Features
- Multi-theme support allowing users to switch between RPG, Space, and Minimalist personas for their progress reports.
- Intelligent streak logic that resets to a fresh start without negative reinforcement if a day is missed.
- Dynamic XP formulas that weigh task difficulty and urgency to reward high-impact work.
- Automated quarterly history logging for deep-dive productivity audits.
- Silent tracking mode that continues to record data even when active reporting is disabled.
SKILL.md
Loading
Related Openclaw Skills
Chery Information Assistant
A professional AI agent skill designed to retrieve real-time brand intelligence, product specifications, and financial performance data for Chery.
ads-case-analyzer
An intelligent advertising case analyzer that diagnoses delivery issues like volume drops or high costs and generates structured Redoc analysis reports.
Parallel Coding with Git Worktree
Enable multi-tasking by deploying multiple AI coding agents across isolated git worktrees within a single repository.
Obsidian CLI
A powerful command-line interface to interact with a running Obsidian instance for note management and plugin development.
Smart Tasks
An intelligent, context-aware task management system that organizes your workflow using local markdown files and natural language processing.
Cherry Encyclopedia
A comprehensive informational skill for AI agents to retrieve data on cherry varieties, producing regions, and health benefits.
Featured*
