m1nuzz

todo-manager

0
0
# Install this skill:
npx skills add m1nuzz/todo-manager-skill

Or install specific skill: npx add-skill https://github.com/m1nuzz/todo-manager-skill

# Description

Manages TODO.md files by creating them in a standardized format and updating them as tasks are completed. Use when Claude needs to track progress on multi-step tasks, maintain task lists, or create structured project plans with completion tracking.

# SKILL.md


name: todo-manager
description: Manages TODO.md files by creating them in a standardized format and updating them as tasks are completed. Use when Claude needs to track progress on multi-step tasks, maintain task lists, or create structured project plans with completion tracking.


TODO Manager Skill

This skill helps create and maintain TODO.md files to track progress on multi-step tasks and projects. It follows a standardized format that includes categories, completion status, and progress tracking.

When to Use This Skill

  • Creating new TODO.md files for multi-step projects
  • Updating existing TODO.md files as tasks are completed
  • Tracking progress on complex tasks with multiple subtasks
  • Maintaining organized task lists with status indicators

Format Standards

Basic Structure

# Project Name - Implementation TODO

## Category Name
- [ ] Task description
- [x] Completed task description
- [-] In-progress task description

Status Indicators

  • [ ] - Not started
  • [x] - Completed
  • [-] - In progress

Categories

Common categories include:
- Core Features
- UI Enhancements
- Advanced Features
- Testing
- Performance
- Documentation

Creating New TODO.md

When creating a new TODO.md file:

  1. Start with a descriptive title including the project name
  2. Organize tasks into logical categories
  3. Use consistent formatting for task items
  4. Include estimated complexity if helpful
  5. Add deadlines or priorities if applicable

Updating Existing TODO.md

When updating an existing TODO.md file:

  1. Locate the specific task to update
  2. Change the status indicator appropriately:
  3. [ ][x] when completed
  4. [ ][-] when in progress
  5. [-][x] when completed
  6. Add completion notes if helpful
  7. Add new tasks if discovered during implementation
  8. Maintain the same formatting standards

Example TODO.md

# Project Name - Implementation TODO

## Core Features
- [x] Basic setup and configuration
- [ ] User authentication system
- [-] Data storage implementation
- [ ] API endpoints

## UI Enhancements
- [ ] Responsive design
- [ ] Dark mode support
- [ ] Accessibility improvements

## Advanced Features
- [ ] Real-time notifications
- [ ] Export functionality
- [ ] Custom themes

## Testing
- [ ] Unit tests for core logic
- [ ] Integration tests
- [ ] UI tests

## Documentation
- [ ] Code documentation
- [ ] User guide
- [ ] API reference

Workflow

  1. Analyze the task - Determine what needs to be done
  2. Check for existing TODO.md - Look for existing task tracking
  3. Create/update TODO.md - Follow the format standards
  4. Track progress - Update status as work progresses
  5. Mark completion - Update tasks to [x] when done

# README.md

TODO Manager Skill

This skill helps manage TODO.md files to track progress on multi-step tasks and projects. It follows a standardized format that includes categories, completion status, and progress tracking.

Overview

The TODO Manager skill provides:

  • Standardized TODO.md format
  • Status tracking with [ ], [x], and [-] indicators
  • Categorization of tasks
  • Progress reporting
  • Script for automated management

Usage

Manual Management

Create and update TODO.md files following the standard format:

# Project Name - Implementation TODO

## Category Name
- [ ] Task description (not started)
- [x] Task description (completed)  
- [-] Task description (in progress)

Automated Management

Use the provided script to manage TODO files:

# Create a new TODO file
python scripts/todo_manager.py create path/to/TODO.md --project "My Project"

# Update task status
python scripts/todo_manager.py update path/to/TODO.md --category "Core Features" --task "Authentication system" --status x

# Add a new task
python scripts/todo_manager.py add path/to/TODO.md --category "UI Enhancements" --task "New feature"

# Generate progress report
python scripts/todo_manager.py report path/to/TODO.md

Categories

Standard categories include:

  • Core Features
  • UI Enhancements
  • Advanced Features
  • Testing
  • Performance
  • Documentation

Status Indicators

  • [ ] - Not started
  • [x] - Completed
  • [-] - In progress

Benefits

  • Consistent format across projects
  • Easy progress tracking
  • Clear task categorization
  • Automated status updates
  • Progress reporting

# Supported AI Coding Agents

This skill is compatible with the SKILL.md standard and works with all major AI coding agents:

Learn more about the SKILL.md standard and how to use these skills with your preferred AI coding agent.