Skip to content

Latest commit

 

History

History

Folders and files

NameName
Last commit message
Last commit date

parent directory

..
 
 
 
 
 
 
 
 
 
 
 
 

README.md

Task Tracker Skill for Clawdbot

Personal task management with daily standups and weekly reviews.

Features

  • 📋 Task Management: Create, list, complete, and archive tasks
  • 📊 Daily Standup: See today's priorities, blockers, and recent completions
  • 📅 Weekly Review: Summarize progress and plan the week ahead
  • 🏷️ Priority Levels: High (🔴), Medium (🟡), Low/Delegated (🟢)
  • Due Dates: Track deadlines and filter by due date
  • 🚧 Blockers: Identify tasks blocking team members
  • 📱 Telegram Integration: Slash commands for quick access
  • 🤖 Automated Briefings: Optional cron jobs for daily/weekly summaries

Quick Start

# Daily standup
python3 ~/clawd/skills/task-tracker/scripts/standup.py

# List all tasks
python3 ~/clawd/skills/task-tracker/scripts/tasks.py list

# Add a task
python3 ~/clawd/skills/task-tracker/scripts/tasks.py add "Task description" --priority high --due 2026-01-25

# Mark task done (fuzzy match)
python3 ~/clawd/skills/task-tracker/scripts/tasks.py done "task keyword"

# Weekly review
python3 ~/clawd/skills/task-tracker/scripts/weekly_review.py

Installation

  1. Clone to your Clawdbot skills directory:

    git clone https://github.com/kesslerio/task-tracker-clawdbot-skill.git \
        ~/clawd/skills/task-tracker
  2. Create tasks file from template:

    cp ~/clawd/skills/task-tracker/assets/templates/TASKS.md \
        ~/clawd/memory/work/TASKS.md
  3. (Optional) Set up Telegram slash commands - see TELEGRAM.md

Task File Format

Tasks are stored in ~/clawd/memory/work/TASKS.md using this format:

## 🔴 High Priority (This Week)

- [ ] **Task title** — Brief description
  - Owner: martin
  - Due: 2026-01-29
  - Status: Todo
  - Blocks: teammate (reason)

Priority Levels

  • 🔴 High: Blocking others, critical deadline, revenue impact
  • 🟡 Medium: Important but not urgent
  • 🟢 Low/Delegated: Monitoring, no deadline pressure

Statuses

  • TodoIn ProgressDone
  • Blocked (waiting on external)
  • Waiting (delegated, monitoring)

Commands

Daily Standup

python3 scripts/standup.py

Output:

  • 🎯 #1 Priority
  • ⏰ Due today
  • 🔴 High priority tasks
  • ✅ Recently completed

Weekly Review

python3 scripts/weekly_review.py

Output:

  • Last week's completions
  • Tasks pushed to this week
  • This week's priorities
  • Automatically archives done tasks

Task Operations

List tasks:

python3 scripts/tasks.py list                          # All tasks
python3 scripts/tasks.py list --priority high          # High priority only
python3 scripts/tasks.py list --status done            # Completed tasks
python3 scripts/tasks.py list --due today              # Due today
python3 scripts/tasks.py list --due this-week          # Due this week
python3 scripts/tasks.py list --owner martin           # My tasks
python3 scripts/tasks.py list --completed-since 24h    # Done last 24h
python3 scripts/tasks.py list --completed-since 7d     # Done last week

Add task:

python3 scripts/tasks.py add "Task description" \
  --priority high \
  --due 2026-01-29 \
  --owner martin \
  --blocks "teammate"

Complete task:

python3 scripts/tasks.py done "task keyword"

Uses fuzzy matching - just type a few words from the task title.

Show blockers:

python3 scripts/tasks.py blockers                # All blockers
python3 scripts/tasks.py blockers --person lilla # Blocking specific person

Archive completed tasks:

python3 scripts/tasks.py archive

Moves done tasks to ARCHIVE-YYYY-QN.md and clears the Done section.

Telegram Slash Commands

Optional integration for Telegram users. See TELEGRAM.md for setup.

Commands:

  • /daily - Daily standup
  • /weekly - Weekly priorities
  • /done24h - Completed last 24 hours
  • /done7d - Completed last 7 days

Cron Jobs (Optional)

Set up automated standups and reviews:

# Daily standup (8:30 AM PT, weekdays)
clawdbot cron add \
  --name "Daily Standup" \
  --schedule "30 8 * * 1-5" \
  --timezone "America/Los_Angeles" \
  --command "python3 ~/clawd/skills/task-tracker/scripts/standup.py"

# Weekly review (9:00 AM PT, Mondays)
clawdbot cron add \
  --name "Weekly Review" \
  --schedule "0 9 * * 1" \
  --timezone "America/Los_Angeles" \
  --command "python3 ~/clawd/skills/task-tracker/scripts/weekly_review.py"

Workflow

  1. Morning: Daily standup surfaces #1 priority
  2. Throughout day: Update status as work progresses
  3. After meetings: Extract tasks with extract_tasks.py
  4. End of week: Weekly review archives done, plans next week

Files

task-tracker/
├── README.md              # This file
├── SKILL.md               # Clawdbot skill documentation
├── TELEGRAM.md            # Telegram integration guide
├── scripts/
│   ├── tasks.py           # Task CRUD operations
│   ├── standup.py         # Daily standup generator
│   ├── weekly_review.py   # Weekly review + archiving
│   ├── extract_tasks.py   # Extract tasks from notes
│   ├── telegram-commands.sh # Telegram slash command wrapper
│   └── init.py            # Initialize tasks file
├── assets/
│   └── templates/
│       └── TASKS.md       # Task file template
└── references/
    └── task-format.md     # Task format specification

Integration with Clawdbot

The agent automatically:

  • Recognizes task-related questions ("What's my #1 priority?")
  • Runs standup when asked ("daily standup")
  • Updates tasks when you say "mark X done"
  • Filters tasks by criteria ("show high priority tasks due this week")

Dependencies

  • Python 3.10+
  • Clawdbot (for cron/messaging integration)

License

Apache 2.0 - See LICENSE file for details.

Related Skills

  • finance-news: AI-powered market briefings with multi-source aggregation (WSJ, Barron's, CNBC), portfolio tracking, and automated WhatsApp delivery in German/English
  • oura-analytics: Sleep and health tracking
  • session-logs: Search conversation history
  • task-tracker: This skill