mirror of
https://github.com/hanzoskill/task-tracker.git
synced 2026-10-30 21:10:55 +00:00
main
Task Tracker Skill for Bot
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 ~/bot/skills/task-tracker/scripts/standup.py
# List all tasks
python3 ~/bot/skills/task-tracker/scripts/tasks.py list
# Add a task
python3 ~/bot/skills/task-tracker/scripts/tasks.py add "Task description" --priority high --due 2026-01-25
# Mark task done (fuzzy match)
python3 ~/bot/skills/task-tracker/scripts/tasks.py done "task keyword"
# Weekly review
python3 ~/bot/skills/task-tracker/scripts/weekly_review.py
Installation
-
Clone to your Bot skills directory:
git clone https://github.com/kesslerio/task-tracker-bot-skill.git \ ~/bot/skills/task-tracker -
Create tasks file from template:
cp ~/bot/skills/task-tracker/assets/templates/TASKS.md \ ~/bot/memory/work/TASKS.md -
(Optional) Set up Telegram slash commands - see TELEGRAM.md
Task File Format
Tasks are stored in ~/bot/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
TodoβIn ProgressβDoneBlocked(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)
bot cron add \
--name "Daily Standup" \
--schedule "30 8 * * 1-5" \
--timezone "America/Los_Angeles" \
--command "python3 ~/bot/skills/task-tracker/scripts/standup.py"
# Weekly review (9:00 AM PT, Mondays)
bot cron add \
--name "Weekly Review" \
--schedule "0 9 * * 1" \
--timezone "America/Los_Angeles" \
--command "python3 ~/bot/skills/task-tracker/scripts/weekly_review.py"
Workflow
- Morning: Daily standup surfaces #1 priority
- Throughout day: Update status as work progresses
- After meetings: Extract tasks with
extract_tasks.py - End of week: Weekly review archives done, plans next week
Files
task-tracker/
βββ README.md # This file
βββ SKILL.md # Bot 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 Bot
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+
- Bot (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
Languages
Python
96.8%
Shell
3.2%