task-tracker

<div align="center">      **Personal task management with daily standups and weekly reviews** [Homepage](https://github.com/kesslerio/task-tracker-clawdbot-skill) • [Trigger Patterns](#what-this-skill-does) • [Commands](#commands-reference) </div> --- # Task Tracker A personal task management skill for daily standups and weekly reviews. Tracks work tasks, surfaces priorities, and manages blockers. --- ## What This Skill Does 1. **Lists tasks** - Shows what's on your plate, filtered by priority, status, or deadline 2. **Daily standup** - Shows today's #1 priority, blockers, and what was completed 3. **Weekly review** - Summarizes last week, archives done items, plans this week 4. **Add tasks** - Create new tasks with priority and due date 5. **Complete tasks** - Mark tasks as done 6. **Extract from notes** - Pull action items from meeting notes --- ## File Structure ``` ~/clawd/memory/work/ ├── TASKS.md # Active tasks (source of truth) ├── ARCHIVE-2026-Q1.md # Completed tasks by quarter └── WORKFLOW.md # Workflow documentation ``` **TASKS.md format:** ```markdown # Work Tasks ## 🔴 High Priority (This Week) - [ ] **Set up Apollo.io** — Access for Lilla - Due: ASAP - Blocks: Lilla (podcast outreach) ## 🟡 Medium Priority (This Week) - [ ] **Review newsletter concept** — Figma design - Due: Before Feb 1 ## ✅ Done - [x] **Set up team calendar** — Shared Google Calendar ``` --- ## Quick Start ### View Your Tasks ```bash python3 ~/clawd/skills/task-tracker/scripts/tasks.py list ``` ### Daily Standup ```bash python3 ~/clawd/skills/task-tracker/scripts/standup.py ``` ### Weekly Review ```bash python3 ~/clawd/skills/task-tracker/scripts/weekly_review.py ``` --- ## Commands Reference ### List Tasks ```bash # All tasks tasks.py list # Only high priority tasks.py list --priority high # Only blocked tasks.py list --status blocked # Due today or this week tasks.py list --due today tasks.py list --due this-week ``` ### Add Task ```bash # Simple tasks.py add "Draft project proposal" # With details tasks.py add "Draft project proposal" \ --priority high \ --due "Before Mar 15" \ --blocks "Sarah (client review)" ``` ### Complete Task ```bash tasks.py done "proposal" # Fuzzy match - finds "Draft project proposal" ``` ### Show Blockers ```bash tasks.py blockers # All blocking tasks tasks.py blockers --person sarah # Only blocking Sarah ``` ### Extract from Meeting Notes ```bash extract_tasks.py --from-text "Meeting: discuss Q1 planning, Sarah to own budget review" # Outputs: tasks.py add "Discuss Q1 planning" --priority medium # tasks.py add "Sarah to own budget review" --owner sarah ``` --- ## Priority Levels | Icon | Meaning | When to Use | |------|---------|-------------| | 🔴 **High** | Critical, blocking, deadline-driven | Revenue impact, blocking others | | 🟡 **Medium** | Important but not urgent | Reviews, feedback, planning | | 🟢 **Low** | Monitoring, delegated | Waiting on others, backlog | --- ## Status Workflow ``` Todo → In Progress → Done ↳ Blocked (waiting on external) ↳ Waiting (delegated, monitoring) ``` --- ## Automation (Cron) | Job | When | What | |-----|------|------| | Daily Standup | Weekdays 8:30 AM | Posts to Telegram Journaling group | | Weekly Review | Mondays 9:00 AM | Posts summary, archives done items | --- ## Natural Language Triggers | You Say | Skill Does | |---------|-----------| | "daily standup" | Runs standup.py, posts to Journaling | | "weekly review" | Runs weekly_review.py, posts summary | | "what's on my plate?" | Lists all tasks | | "what's blocking Lilla?" | Shows tasks blocking Lilla | | "mark IMCAS done" | Completes matching task | | "what's due this week?" | Lists tasks due this week | | "add task: X" | Adds task X to TASKS.md | | "extract tasks from: [notes]" | Parses notes, outputs add commands | --- ## Examples **Morning check-in:** ``` $ python3 scripts/standup.py 📋 Daily Standup — Tuesday, January 21 🎯 #1 Priority: Complete project proposal draft ↳ Blocking: Sarah (client review) ⏰ Due Today: • Complete project proposal draft • Schedule team sync 🔴 High Priority: • Review Q1 budget (due: Before Mar 15) • Draft blog post (due: ASAP) ✅ Recently Completed: • Set up shared calendar • Update team documentation ``` **Adding a task:** ``` $ python3 scripts/tasks.py add "Draft blog post" --priority high --due ASAP ✅ Added task: Draft blog post ``` **Extracting from meeting notes:** ``` $ python3 scripts/extract_tasks.py --from-text "Meeting: Sarah needs budget review, create project timeline" # Extracted 2 task(s) from meeting notes # Run these commands to add them: tasks.py add "Budget review for Sarah" --priority high tasks.py add "Create project timeline" --priority medium ``` --- ## Integration Points - **Telegram Journaling group:** Standup/review summaries posted automatically - **Obsidian:** Daily standups logged to `01-Daily/YYYY-MM-DD.md` - **MEMORY.md:** Patterns and recurring blockers promoted during weekly reviews - **Cron:** Automated standups and reviews --- ## Troubleshooting **"Tasks file not found"** ```bash # Create from template python3 scripts/init.py ``` **Tasks not showing up** - Check TASKS.md exists at `~/clawd/memory/work/TASKS.md` - Verify task format (checkboxes `- [ ]`, headers `## 🔴`) - Run `tasks.py list` to debug **Date parsing issues** - Due dates support: `ASAP`, `YYYY-MM-DD`, `Before Mar 15`, `Before product launch` - `check_due_date()` handles common formats --- ## Files | File | Purpose | |------|---------| | `scripts/tasks.py` | Main CLI - list, add, done, blockers, archive | | `scripts/standup.py` | Daily standup generator | | `scripts/weekly_review.py` | Weekly review generator | | `scripts/extract_tasks.py` | Extract tasks from meeting notes | | `scripts/utils.py` | Shared utilities (DRY) | | `scripts/init.py` | Initialize new TASKS.md from template | | `references/task-format.md` | Task format specification | | `assets/templates/TASKS.md` | Template for new task files |