habitica

What This Skill Does

The Habitica skill provides a seamless, command-line interface for the Habitica gamified task management system within OpenClaw. It transforms your CLI environment into a powerful dashboard to manage your habits, daily tasks, to-dos, and rewards. By mapping OpenClaw natural language processing to the Habitica API, you can track progress, level up your character, and manage party interactions without leaving your terminal. The skill supports full task lifecycle management, including creation, scoring, updating, and deletion, as well as character progression, inventory management, and party social features.

Installation

To integrate this skill, use the OpenClaw hub command: clawhub install openclaw/skills/skills/tonyunturn/habitica-skill. Once installed, you must authenticate by creating a ~/.habitica file containing your HABITICA_USER_ID and HABITICA_API_TOKEN. These credentials can be retrieved directly from the Habitica settings menu under Site Data. Ensure your file permissions are restricted to your user for security.

Use Cases

This skill is perfect for power users who want to stay focused within a CLI workflow. It is ideal for individuals who leverage gamification to maintain productivity. Common use cases include: checking off your daily tasks while starting your morning workflow, scoring habits as they occur during a coding session, managing party-wide quests without opening a browser tab, and using your character's class-specific abilities to boost efficiency. It is especially useful for managing batch updates where you might want to clear multiple tasks at once through sub-agent delegation.

Example Prompts

1. "Habitica, please check off my 'Daily Exercise' task and list all my remaining todos for the afternoon."
2. "I just finished my deep work session; score my 'Deep Work' habit up and cast 'Fireball' if I have enough mana."
3. "OpenClaw, perform a batch operation: score my 'Read Book' habit, mark 'Buy Groceries' as complete, and tell me my current party status."

Tips & Limitations

Note that the tool uses the specific spelling dailys for daily task operations. Because Habitica enforces rate limits, the skill is optimized for human-speed interaction; avoid rapid-fire programmatic loops that exceed the 30-second interval constraint. For complex task management, utilize sub-agents as described in the documentation to ensure the main chat remains responsive. Always ensure your API credentials remain private.