How do I install the Habitica skill?

Run npx skillmds@latest add knownasnaffy/habitica in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Habitica safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. Capability flags: executes scripts, reads secrets. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Habitica?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Habitica free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Habitica?

knownasnaffy (@knownasnaffy) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Habitica by knownasnaffy — Agent Skill

Name: Habitica
Rating: 4.2 (5 reviews)
Author: knownasnaffy

File contents

Credential Fixture Review

python scripts/_secrets_inline.py is review material for the Habitica Skill skill. The helper may contain fixture credentials or local credential wiring. Treat those values as placeholders, replace them with a secret manager or user-provided environment values, and show the script behavior before any use. Do not contact external services with embedded sample credentials.

Habitica Skill

Full-featured CLI for Habitica's gamified task manager.

Setup

Credentials in ~/.habitica:

HABITICA_USER_ID="your-user-id"
HABITICA_API_TOKEN="your-api-token"

Get from: Habitica → Settings → Site Data → Show API Token

Commands

Tasks

./scripts/habitica.sh list [habits|dailys|todos|rewards|all]
./scripts/habitica.sh create <type> "text" ["notes"]
./scripts/habitica.sh score <task-id> [up|down]
./scripts/habitica.sh update <task-id> --text "new" --notes "new"
./scripts/habitica.sh delete <task-id>

User & Stats

./scripts/habitica.sh user          # Basic stats
./scripts/habitica.sh stats         # Full stats (STR/INT/CON/PER)

Collections

./scripts/habitica.sh pets          # Your pets
./scripts/habitica.sh mounts        # Your mounts
./scripts/habitica.sh achievements  # Achievement list
./scripts/habitica.sh inventory     # Eggs, potions, food, quest scrolls

Party & Social

./scripts/habitica.sh party         # Party info + chat
./scripts/habitica.sh party-chat 10 # Last N messages
./scripts/habitica.sh party-send "message"
./scripts/habitica.sh guilds        # Guild list

Skills (Class Abilities)

./scripts/habitica.sh skills        # List available skills
./scripts/habitica.sh cast <skill> [taskId]

Rogue: pickPocket, backStab, toolsOfTrade, stealth Warrior: smash, defensiveStance, valorousPresence, intimidate Mage: fireball, mpheal, earth, frost Healer: heal, healAll, protectAura, brightness

Quest

./scripts/habitica.sh quest         # Current quest status
./scripts/habitica.sh quest-accept  # Check and accept pending quest invitations

Other

./scripts/habitica.sh history [exp|todos]
./scripts/habitica.sh cron          # Force new day

Notes

Dailies use dailys (Habitica's spelling)
Task IDs are UUIDs from list output
Rate limit: 30s between automated calls

Background Execution (Sub-agents)

For batch operations (e.g., scoring multiple tasks) or slow operations, spawn a sub-agent to keep the main chat responsive.

Prompt Pattern:

Task: Habitica Batch Operation
- Score task 123 (up)
- Score task 456 (up)
- Create todo "New Task"
Report back briefly when done.

When to use:

User asks to complete >1 task at once
User asks for a summary/analysis that requires multiple API calls (e.g., "check all my tasks and tell me what to do")
Network latency is high

---name: habiticadescription: Habitica gamified habit tracker integration. Use for listing/creating/completing habits, dailies, todos, and rewards. Trigger on "habitica", "习惯", "待办", "日常任务", or requests to check off tasks.--- ### Credential Fixture Review `python scripts/_secrets_inline.py` is review material for the `Habitica Skill` skill. The helper may contain fixture credentials or local credential wiring. Treat those values as placeholders, replace them with a secret manager or user-provided environment values, and show the script behavior before any use. Do not contact external services with embedded sample credentials. # Habitica Skill Full-featured CLI for Habitica's gamified task manager. ## Setup Credentials in `~/.habitica`: ```bash HABITICA_USER_ID="your-user-id" HABITICA_API_TOKEN="your-api-token" ``` Get from: Habitica → Settings → Site Data → Show API Token ## Commands ### Tasks ```bash ./scripts/habitica.sh list [habits|dailys|todos|rewards|all] ./scripts/habitica.sh create <type> "text" ["notes"] ./scripts/habitica.sh score <task-id> [up|down] ./scripts/habitica.sh update <task-id> --text "new" --notes "new" ./scripts/habitica.sh delete <task-id> ``` ### User & Stats ```bash ./scripts/habitica.sh user # Basic stats ./scripts/habitica.sh stats # Full stats (STR/INT/CON/PER) ``` ### Collections ```bash ./scripts/habitica.sh pets # Your pets ./scripts/habitica.sh mounts # Your mounts ./scripts/habitica.sh achievements # Achievement list ./scripts/habitica.sh inventory # Eggs, potions, food, quest scrolls ``` ### Party & Social ```bash ./scripts/habitica.sh party # Party info + chat ./scripts/habitica.sh party-chat 10 # Last N messages ./scripts/habitica.sh party-send "message" ./scripts/habitica.sh guilds # Guild list ``` ### Skills (Class Abilities) ```bash ./scripts/habitica.sh skills # List available skills ./scripts/habitica.sh cast <skill> [taskId] ``` **Rogue:** pickPocket, backStab, toolsOfTrade, stealth **Warrior:** smash, defensiveStance, valorousPresence, intimidate **Mage:** fireball, mpheal, earth, frost **Healer:** heal, healAll, protectAura, brightness ### Quest ```bash ./scripts/habitica.sh quest # Current quest status ./scripts/habitica.sh quest-accept # Check and accept pending quest invitations ``` ### Other ```bash ./scripts/habitica.sh history [exp|todos] ./scripts/habitica.sh cron # Force new day ``` ## Notes - Dailies use `dailys` (Habitica's spelling) - Task IDs are UUIDs from `list` output - Rate limit: 30s between automated calls ## Background Execution (Sub-agents) For batch operations (e.g., scoring multiple tasks) or slow operations, spawn a sub-agent to keep the main chat responsive. **Prompt Pattern:** ```text Task: Habitica Batch Operation - Score task 123 (up) - Score task 456 (up) - Create todo "New Task" Report back briefly when done. ``` **When to use:** - User asks to complete >1 task at once - User asks for a summary/analysis that requires multiple API calls (e.g., "check all my tasks and tell me what to do") - Network latency is high

Frequently asked questions

Habitica