Habit Tracker

Track daily habits, streaks, and completions locally. Triggers on: habit, streak, track habit, log exercise, log habit, weekly review, habit status, did I ex...

Security Scan

This skill is internally consistent: it performs only local habit tracking, reads/writes JSON/Markdown under a user workspace, and does not request credentials or network access.

Purpose & Capability

Name/description match the implementation: scripts manage habits, logs, status, and weekly reviews stored in local JSON/Markdown files. No unrelated capabilities or credentials are requested.

Instruction Scope

SKILL.md and the scripts limit actions to local files under ~/.openclaw/workspace/habits (configurable via HABIT_DATA_DIR) and an optional vault path for Obsidian. There are no instructions to read unrelated system files, contact external endpoints, or exfiltrate data.

Install Mechanism

Instruction-only skill with bundled Python scripts; no install spec, no downloads, and no package installation. Scripts are plain Python and operate locally.

Credentials

The only environment variable referenced is HABIT_DATA_DIR (to override the data directory). No secrets, API keys, or unrelated environment variables are required.

Persistence & Privilege

The skill writes persistent files to the user's home under ~/.openclaw/workspace/habits and (optionally) the vault path for weekly reviews. It does not request elevated privileges or force inclusion (always:false). Review and accept that it will create/modify files in those directories.

Assessment

This skill appears safe and does what it says: local habit tracking using JSON and optional Markdown exports. Before installing, be aware it will create and modify files in ~/.openclaw/workspace/habits (you can change this with HABIT_DATA_DIR) and may write weekly notes to a vault path (DEFAULT_VAULT_DIR). If you keep sensitive material in those folders, consider choosing a different data-dir or encrypting backups. If you want extra assurance, open the included Python scripts (they are short and readable) to verify behavior; there are no network calls or secret access in the code.

Habit Tracker Skill

Local habit tracking via JSON files. No external services or API keys. Data lives in ~/.openclaw/workspace/habits/ (override with HABIT_DATA_DIR env var).

Scripts live in scripts/ relative to this file. Resolve all script paths relative to this skill's scripts/ directory.

---

Commands

List habits

python scripts/setup_habits.py --list

Add a habit

python scripts/setup_habits.py --add "Habit Name" --frequency daily|weekday|weekly --emoji 🏋️

• --frequency defaults to daily if omitted
• --emoji is optional

Remove (archive) a habit

python scripts/setup_habits.py --remove "Habit Name"

History is preserved. Habit is soft-deleted.

Log a habit completion

python scripts/log_habit.py "Habit Name"
python scripts/log_habit.py "Habit Name" --date 2024-01-15
python scripts/log_habit.py "Habit Name" --undo

• Accepts exact name, partial name, or ID
• Prevents duplicate logging (safe to re-run)
• --undo removes today's log entry

Check status

python scripts/status.py
python scripts/status.py --json
python scripts/status.py --date 2024-01-15

Outputs current streak, longest streak, today's completion, and 7/30-day rates.

Weekly review

python scripts/weekly_review.py
python scripts/weekly_review.py --week 2024-01-15
python scripts/weekly_review.py --output ~/Desktop/review.md
python scripts/weekly_review.py --obsidian

Generates a formatted markdown report. --obsidian saves to vault/habits/weekly-reviews/YYYY-MM-DD.md.

---

Interpreting User Requests

User says	Action
"Did I exercise today?"	status.py --json → find habit by name
"Log my run / I exercised"	log_habit.py "Exercise"
"What's my reading streak?"	status.py --json → extract streak for reading
"Log yesterday's meditation"	log_habit.py "Meditation" --date YYYY-MM-DD
"Weekly review"	weekly_review.py
"Add habit: cold shower"	setup_habits.py --add "Cold Shower"
"Show all habits"	setup_habits.py --list
"Remove journaling"	setup_habits.py --remove "Journaling"

---

Frequency Semantics

• daily — expected every calendar day
• weekday — Mon–Fri only; weekend skips don't break streaks
• weekly — once per 7-day window; streak = consecutive weeks with ≥1 completion

---

Output Handling

• status.py (no --json): print directly to user
• status.py --json: parse and reformat as a clean bullet list for Discord
• weekly_review.py: offer to save to Obsidian (--obsidian) or print inline
• Always confirm after log_habit.py with what was logged and current streak

---

Data Location

~/.openclaw/workspace/habits/
├── habits.json   # habit definitions
└── log.json      # daily completion records

Both files are auto-created. See references/data-format.md for schema details.