todo-work

Surface pending tasks from TODO.md and mark them in progress.

Updated Mar 29, 2026
One-click install
npx skills add https://github.com/nexus-a1/claude-skills --skill todo-work
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: todo-work
Source: https://github.com/nexus-a1/claude-skills/tree/main/skills/todo-work
Command: npx skills add https://github.com/nexus-a1/claude-skills --skill todo-work

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Surface pending items from TODO.md, lets the user pick one, mark it In progress, and propose a hand-off to downstream skills by printing the exact command to run next.

Core Features & Use Cases

  • Surface pending items from TODO.md and present them for selection.
  • Allow marking the selected item as In progress and optionally continue with a downstream hand-off to /review-plan or /implement.
  • Provide a Just show details option to view the item without changing its status or creating worktrees.

Quick Start

Run /todo-work to list pending TODO items and start the interactive flow.

Frequently Asked Questions about todo-work

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I surface pending TODO items from a markdown file for project management?

Yes, you can view pending TODO items without changing their status by selecting the Just show details option. This presents the item content from TODO.md without triggering status updates or creating Git worktrees.

How do I hand off software development tasks to isolated Git worktrees?

You can hand off software development tasks by selecting an item from TODO.md, marking it in progress, and using the proposed downstream hand-off command. This process requires interaction with Git worktrees to establish isolated work contexts.

What is the best way to track issue status and transition work to implementation?

The best way to track issue status and transition to implementation is to list pending items from TODO.md, update the selected task to in progress, and execute the printed command to hand off work directly to downstream implementation steps.

Can I review a TODO.md task details without creating a Git worktree?

Yes, you can view pending TODO items without changing their status by selecting the Just show details option. This presents the item content from TODO.md without triggering status updates or creating Git worktrees.