format-todo-list

Generate properly formatted TodoWrite lists for orchestrator progress tracking. Use when creating phase checklists, updating task status, or ensuring consistent todo formatting.

⭐27stars🔀8forks📁View on GitHub🕐Updated Dec 30, 2025⬇️2downloads

When & Why to Use This Skill

This Claude skill automates the generation and formatting of structured todo lists specifically designed for orchestrator progress tracking. It ensures data consistency by validating task statuses and automatically generating active-form descriptions, which is essential for maintaining clear, real-time visibility into complex agentic workflows and multi-phase autonomous tasks.

Use Cases

  • Orchestrator Phase Initialization: Automatically generating a structured checklist of phases and tasks when an agent begins a complex, multi-step project.
  • Real-time Status Updates: Dynamically updating the progress and active state of tasks as an AI agent completes different steps of a workflow to keep the orchestrator synchronized.
  • Standardizing Progress Logs: Ensuring all task descriptions follow a consistent present-continuous format (e.g., 'Implementing' instead of 'Implement') for better readability in monitoring dashboards and logs.
  • Workflow Validation: Validating that task statuses conform to allowed values (pending, in_progress, completed) to prevent errors in downstream tracking tools.
nameformat-todo-list
descriptionGenerate properly formatted TodoWrite lists for orchestrator progress tracking. Use when creating phase checklists, updating task status, or ensuring consistent todo formatting.

Format Todo List

Create properly structured todo lists for TodoWrite tool with correct status and activeForm fields.

When to Use

  • Creating initial phase checklists in orchestrators
  • Updating todo list status
  • Ensuring consistent todo formatting
  • Generating progress tracking lists

Instructions

Step 1: Receive Todo Items

Accept array of todo items with status.

Expected Input:

{
  "todos": [
    {
      "content": "Phase 1: Discovery",
      "status": "completed"
    },
    {
      "content": "Phase 2: Implementation",
      "status": "in_progress"
    },
    {
      "content": "Phase 3: Validation",
      "status": "pending"
    }
  ]
}

Step 2: Generate Active Forms

Create activeForm for each todo based on content.

Rules:

  • Convert imperative to present continuous
  • "Run X" → "Running X"
  • "Create X" → "Creating X"
  • "Fix X" → "Fixing X"
  • "Validate X" → "Validating X"

Step 3: Validate Status

Ensure status is valid TodoWrite value.

Valid Statuses:

  • pending: Not started
  • in_progress: Currently active
  • completed: Finished

Step 4: Format for TodoWrite

Structure data for TodoWrite tool.

Expected Output:

{
  "todos": [
    {
      "content": "Phase 1: Discovery",
      "status": "completed",
      "activeForm": "Discovering and analyzing"
    },
    {
      "content": "Phase 2: Implementation",
      "status": "in_progress",
      "activeForm": "Implementing changes"
    },
    {
      "content": "Phase 3: Validation",
      "status": "pending",
      "activeForm": "Validating results"
    }
  ]
}

Error Handling

  • Invalid Status: Return error listing valid statuses
  • Missing Content: Return error for empty content
  • Empty Array: Return error requesting at least one todo

Examples

Example 1: Phase Checklist

Input:

{
  "todos": [
    {"content": "Phase 0: Pre-flight validation", "status": "completed"},
    {"content": "Phase 1: Bug detection", "status": "in_progress"},
    {"content": "Phase 2: Bug fixes", "status": "pending"},
    {"content": "Phase 3: Verification", "status": "pending"}
  ]
}

Output:

{
  "todos": [
    {
      "content": "Phase 0: Pre-flight validation",
      "status": "completed",
      "activeForm": "Validating pre-flight checks"
    },
    {
      "content": "Phase 1: Bug detection",
      "status": "in_progress",
      "activeForm": "Detecting bugs"
    },
    {
      "content": "Phase 2: Bug fixes",
      "status": "pending",
      "activeForm": "Fixing bugs"
    },
    {
      "content": "Phase 3: Verification",
      "status": "pending",
      "activeForm": "Verifying fixes"
    }
  ]
}

Example 2: Simple Task List

Input:

{
  "todos": [
    {"content": "Run type check", "status": "completed"},
    {"content": "Run build", "status": "completed"},
    {"content": "Run tests", "status": "in_progress"}
  ]
}

Output:

{
  "todos": [
    {
      "content": "Run type check",
      "status": "completed",
      "activeForm": "Running type check"
    },
    {
      "content": "Run build",
      "status": "completed",
      "activeForm": "Running build"
    },
    {
      "content": "Run tests",
      "status": "in_progress",
      "activeForm": "Running tests"
    }
  ]
}

Example 3: Priority-Based List

Input:

{
  "todos": [
    {"content": "Fix critical bugs", "status": "completed"},
    {"content": "Fix high-priority bugs", "status": "in_progress"},
    {"content": "Fix medium-priority bugs", "status": "pending"}
  ]
}

Output:

{
  "todos": [
    {
      "content": "Fix critical bugs",
      "status": "completed",
      "activeForm": "Fixing critical bugs"
    },
    {
      "content": "Fix high-priority bugs",
      "status": "in_progress",
      "activeForm": "Fixing high-priority bugs"
    },
    {
      "content": "Fix medium-priority bugs",
      "status": "pending",
      "activeForm": "Fixing medium-priority bugs"
    }
  ]
}

Validation

  • Generates activeForm for all items
  • Validates status values
  • Handles various content formats
  • Preserves original content
  • Returns proper TodoWrite structure

Supporting Files

  • template.json: TodoWrite format template (see Supporting Files section)