Task Tracker

Manages todos.md — the central task list maintained by the action-item-extractor skill. Use this skill to view, update, and monitor tasks after they've been added.

Configuration

Default path (edit to match your environment):

TODOS_FILE: ~/todos.md

Operations

1. List Items

Show open todos, optionally filtered by owner.

Steps:

1. Read todos.md
2. Extract all lines under ## Open matching - [ ]
3. If an owner filter is provided, return only lines containing {Owner}
4. Format output:

`` Open todos [for {Owner}]: 1. [{Owner}] {Task} — due: {deadline} (source: {source}) ... ``

1. If no items match: "No open todos [for {Owner}]."

Usage examples:

• "Show all open todos"
• "What does Alice need to do?"
• "List tasks for Bob"

2. Complete Item

Mark a todo as done.

Steps:

1. Read todos.md
2. Identify the matching item — by number (from List output), owner + keyword, or exact task text
3. If ambiguous (multiple matches), show options and ask the user to confirm
4. Change - [ ] to - [x] and append (completed: {today's date})
5. Move the line from ## Open to ## Done
6. Write the updated file
7. Confirm: "Marked as done: {task}"

Usage examples:

• "Mark Alice's design task as done"
• "Complete item 2"
• "Done: project proposal"

3. Query by Owner

Show all todos (open and done) for a specific person.

Steps:

1. Read todos.md
2. Extract all lines (both ## Open and ## Done) matching {Owner}
3. Format output:

``` Todos for {Owner}:

Open: - {Task} (due: {deadline})

Done: - {Task} (completed: {date}) ```

1. If none found: "No todos found for {Owner}."

Scheduled Alerting

On each scheduled run, check for overdue or upcoming tasks.

Steps:

1. Read todos.md
2. For each open item with a concrete deadline (not TBD):

- If due date < today: flag as overdue - If due date <= today + 2 days: flag as due soon

1. If flagged items exist, send an alert:

`` ⚠️ Task Alert: Overdue ({N}): - [{Owner}] {Task} — was due {date} Due soon ({N}): - [{Owner}] {Task} — due {date} ``

1. If nothing flagged: no alert needed, exit silently

Tip: Configure your agent to run this skill periodically so overdue alerts fire automatically without manual prompting.

Error Handling

• File not found: Notify the user — todos.md doesn't exist yet. Direct them to run action-item-extractor or add a task manually
• Ambiguous match on Complete: Show matching items, ask user to confirm which one
• No deadlines set (all TBD): Scheduled check skips alerting silently
• Malformed todos.md: Notify the user and ask whether to overwrite with a clean template or attempt repair