mcpField
T
task-management

task-management

github.com/w95Productivity28538 installsUpdated 35w ago
Repository

About task-management

A skill for tracking tasks in a `TASKS.md` file in the current working directory, for people who want a simple file-based task list. It also supports a companion dashboard and defines how to add, complete, and organize tasks.

Key features

  1. 01Maintain tasks in `TASKS.md`
  2. 02Group tasks by active, waiting, and someday
  3. 03Add and complete tasks using defined formats
  4. 04Use a dashboard synchronized with `TASKS.md`
  5. 05Extract action items with confirmation first

Use cases

  1. 01Review current tasks and urgent items
  2. 02Record commitments, owners, and due dates
  3. 03Track items awaiting a response
  4. 04Organize action items from meetings

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/w95/awesome-claude-corporate-skills --skill task-management

After installing, type/task-managementin Claude Code to confirm it loaded.

Details

From the project README

Task Management

Tasks are tracked in a simple TASKS.md file that both you and the user can edit.

File Location

Always use TASKS.md in the current working directory.

  • If it exists, read/write to it
  • If it doesn't exist, create it with the template below

Dashboard Setup (First Run)

A visual dashboard is available for managing tasks and memory. On first interaction with tasks:

  1. Check if dashboard.html exists in the current working directory
  2. If not, copy it from ${CLAUDE_PLUGIN_ROOT}/skills/dashboard.html to the current working directory
  3. Inform the user: "I've added the dashboard. Run /productivity:start to set up the full system."

The task board:

  • Reads and writes to the same TASKS.md file
  • Auto-saves changes
  • Watches for external changes (syncs when you edit via CLI)
  • Supports drag-and-drop reordering of tasks and sections

Format & Template

When creating a new TASKS.md, use this exact template (without example tasks):

# Tasks

## Active

## Waiting On

## Someday

## Done

Task format:

  • - [ ] **Task title** - context, for whom, due date
  • Sub-bullets for additional details
  • Completed: - [x] ~~Task~~ (date)

How to Interact

When user asks "what's on my plate" / "my tasks":

  • Read TASKS.md
  • Summarize Active and Waiting On sections
  • Highlight anything overdue or urgent

When user says "add a task" / "remind me to":

  • Add to Active section with - [ ] **Task** format
  • Include context if provided (who it's for, due date)

When user says "done with X" / "finished X":

  • Find the task
  • Change [ ] to [x]
  • Add strikethrough: ~~task~~
  • Add completion date
  • Move to Done section

When user asks "what am I waiting on":

  • Read the Waiting On section
  • Note how long each item has been waiting

Conventions

  • Bold the task title for scannability
  • Include "for [person]" when it's a commitment to someone
  • Include "due [date]" for deadlines
  • Include "since [date]" for waiting items
  • Sub-bullets for additional context
  • Keep Done section for ~1 week, then clear old items

Extracting Tasks

When summarizing meetings or conversations, offer to add extracted tasks:

  • Commitments the user made ("I'll send that over")
  • Action items assigned to them
  • Follow-ups mentioned

Ask before adding - don't auto-add without confirmation.

Comments

Markdown supported