How do I install the Beaverhabits skill?

Run npx skillmds@latest add modbender/beaverhabits 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.

What does the Beaverhabits skill do?

Track and manage your habits using the Beaver Habit Tracker API. It is listed under Integrations & APIs on SkillMD.

Is Beaverhabits safe to use?

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

Which AI agents work with Beaverhabits?

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 Beaverhabits free to use?

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

Who published Beaverhabits?

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

Beaverhabits by modbender — Agent Skill

Name: Beaverhabits
Rating: 4.666666666666667 (3 reviews)
Author: modbender

File contents

Beaver Habit Tracker

Track and manage your daily habits using the Beaver Habit Tracker API.

API documentation: https://beaverhabits.com/docs

Setup

Environment Variables

Variable	Required	Default	Description
`BEAVERHABITS_API_KEY`	Yes	—	Your permanent API token from the Beaver Habits settings page
`SERVER_URL`	No	`https://beaverhabits.com`	Your Beaver Habits server URL (for self-hosted instances)

Getting Your API Key

Log in to your Beaver Habits instance
Open the menu → Tools → API Tokens
Click "Generate API Token"
Copy the token and set it as BEAVERHABITS_API_KEY

Tools

list_habits (overview)

List all habits and show a weekly ASCII overview. This is the default response for any habit-related query.

Step 1 — Get all habits:

curl -s -H "Authorization: Bearer $BEAVERHABITS_API_KEY" \
  "${SERVER_URL:-https://beaverhabits.com}/api/v1/habits"

Step 2 — For each habit, get completions over the last 5 days:

curl -s -H "Authorization: Bearer $BEAVERHABITS_API_KEY" \
  "${SERVER_URL:-https://beaverhabits.com}/api/v1/habits/{habit_id}/completions?date_fmt=%25d-%25m-%25Y&date_start={start}&date_end={end}&limit=100&sort=asc"

Response format: ["16-02-2026", "18-02-2026"] (array of completed date strings)

Step 3 — Render as ASCII table:

Example output:

              Mon   Tue   Wed   Thu   Fri   
Exercise       ✗     ✗     ✗     ✗     ✗     
English        ✓     ✗     ✗     ✗     ✗     
paipai         ✗     ✗     ✗     ✗     ✓     
Reading        ✗     ✗     ✗     ✗     ✗     
Table Tennis   ✗     ✗     ✗     ✗     ✗

Use ✓ for done, ✗ for not done. Default to 5 days ending today. Emoji are stripped from habit names for proper alignment.

complete_habit

Mark a habit as done (or undone) for a specific date.

Parameters:

habit_id (resolved): Automatically resolved by calling list_habits and matching the user's habit name. Never ask the user for this value.
date (required): Date in DD-MM-YYYY format
done (optional): true to complete, false to uncomplete (default: true)

curl -s -X POST \
  -H "Authorization: Bearer $BEAVERHABITS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date": "20-02-2026", "done": true, "date_fmt": "%d-%m-%Y"}' \
  "${SERVER_URL:-https://beaverhabits.com}/api/v1/habits/{habit_id}/completions"

Response: {"day": "20-02-2026", "done": true}

Usage Instructions

When the user asks to list, show, or check habits, always respond with the ASCII overview table (not a plain list).
After completing or uncompleting a habit, always re-render the overview table to show the updated state.
Resolve habit names → IDs via list_habits. Never ask the user for a habit_id.
Default to today's date for completions unless specified. Use date_fmt=%d-%m-%Y.

---name: beaverhabitsdescription: Track and manage your habits using the Beaver Habit Tracker API.--- # Beaver Habit Tracker Track and manage your daily habits using the [Beaver Habit Tracker](https://beaverhabits.com) API. API documentation: [https://beaverhabits.com/docs](https://beaverhabits.com/docs) ## Setup ### Environment Variables | Variable | Required | Default | Description | |----------|----------|---------|-------------| | `BEAVERHABITS_API_KEY` | Yes | — | Your permanent API token from the Beaver Habits settings page | | `SERVER_URL` | No | `https://beaverhabits.com` | Your Beaver Habits server URL (for self-hosted instances) | ### Getting Your API Key 1. Log in to your Beaver Habits instance 2. Open the menu → Tools → API Tokens 3. Click "Generate API Token" 4. Copy the token and set it as `BEAVERHABITS_API_KEY` ## Tools ### list_habits (overview) List all habits and show a weekly ASCII overview. This is the **default response** for any habit-related query. **Step 1** — Get all habits: ```bash curl -s -H "Authorization: Bearer $BEAVERHABITS_API_KEY" \ "${SERVER_URL:-https://beaverhabits.com}/api/v1/habits" ``` **Step 2** — For each habit, get completions over the last 5 days: ```bash curl -s -H "Authorization: Bearer $BEAVERHABITS_API_KEY" \ "${SERVER_URL:-https://beaverhabits.com}/api/v1/habits/{habit_id}/completions?date_fmt=%25d-%25m-%25Y&date_start={start}&date_end={end}&limit=100&sort=asc" ``` Response format: `["16-02-2026", "18-02-2026"]` (array of completed date strings) **Step 3** — Render as ASCII table: Example output: ``` Mon Tue Wed Thu Fri Exercise ✗ ✗ ✗ ✗ ✗ English ✓ ✗ ✗ ✗ ✗ paipai ✗ ✗ ✗ ✗ ✓ Reading ✗ ✗ ✗ ✗ ✗ Table Tennis ✗ ✗ ✗ ✗ ✗ ``` Use `✓` for done, `✗` for not done. Default to 5 days ending today. Emoji are stripped from habit names for proper alignment. ### complete_habit Mark a habit as done (or undone) for a specific date. Parameters: - `habit_id` (resolved): Automatically resolved by calling list_habits and matching the user's habit name. Never ask the user for this value. - `date` (required): Date in DD-MM-YYYY format - `done` (optional): true to complete, false to uncomplete (default: `true`) ```bash curl -s -X POST \ -H "Authorization: Bearer $BEAVERHABITS_API_KEY" \ -H "Content-Type: application/json" \ -d '{"date": "20-02-2026", "done": true, "date_fmt": "%d-%m-%Y"}' \ "${SERVER_URL:-https://beaverhabits.com}/api/v1/habits/{habit_id}/completions" ``` Response: `{"day": "20-02-2026", "done": true}` ## Usage Instructions - When the user asks to list, show, or check habits, always respond with the ASCII overview table (not a plain list). - After completing or uncompleting a habit, always re-render the overview table to show the updated state. - Resolve habit names → IDs via list_habits. Never ask the user for a habit_id. - Default to today's date for completions unless specified. Use `date_fmt=%d-%m-%Y`.

Frequently asked questions

Beaverhabits