goalgetter_skill

Overview

This skill manages tasks and habit-style goals using plain Markdown files stored under ~/.openclaw/goalgetter/. It provides simple commands to add, list, complete tasks and to create goals with streak tracking and logs. It requires no external dependencies and keeps an archive of completed items for easy backup or inspection.

How this skill works

All data lives in a local folder: tasks.md for todos, goals.md for goal definitions and streaks, and a done/ folder for archived completions. Commands append, read, or rewrite these Markdown files: adding tasks writes a checklist line, completing a task moves it into done/TIMESTAMP.md and marks it complete, creating or marking a goal updates goals.md and its streak log. Dates use ISO format (YYYY-MM-DD) for consistency.

When to use it

• Quickly capture one-off tasks without a database or external app
• Track daily habits or goals with simple streak counts
• Keep a portable, human-readable archive of completed work
• Automate scripts that need to read or update a todo file
• Use on systems with minimal tooling or restricted internet access

Best practices

• Ensure ~/.openclaw/goalgetter/ exists before running commands
• Use ISO dates (YYYY-MM-DD) when adding log entries to goals.md
• Preview files (read) before modifying to avoid conflicts
• Archive by moving completed items into done/ with timestamps
• Keep tasks.md and goals.md under version control or backup regularly

Example use cases

• Add a task from the command line: echo "- [ ] Finish report" >> ~/.openclaw/goalgetter/tasks.md
• Mark a task done: find the line in tasks.md, move it to done/2026-02-17.md, and change [ ] to [x]
• Create a new goal: append a goal header, a streak field, creation date, and a log block to goals.md
• Record a habit completion: increment the goal's streak and append today's date to its log
• Display all goals and streaks by parsing goals.md to show each goal and its streak