todo-worker

Select and execute the next dependency-validated task from TODO.md.

36|1|Updated Mar 24, 2026
One-click install
npx skills add https://github.com/jiahao-shao1/sjh-skills --skill todo-worker
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: todo-worker
Source: https://github.com/jiahao-shao1/sjh-skills/tree/main/skills/todo-worker
Command: npx skills add https://github.com/jiahao-shao1/sjh-skills --skill todo-worker

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Pick the next executable task from a project-root TODO.md by priority and dependencies, then mark it in-progress and start executing, reducing manual triage time and interruptions.

Core Features & Use Cases

  • Dependency-aware task selection based on priority and declared dependencies.
  • Atomic claim: marks the chosen task as in-progress to prevent race conditions across sessions.
  • Project-driven execution: executes the selected task while keeping TODO.md as the single source of truth.

Quick Start

Invoke the skill with a prompt like 'work on todo' to automatically pick, claim, and begin executing the next task from TODO.md.

Frequently Asked Questions about todo-worker

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

FAQPage Schema
How do I automatically pick and start the next task from a TODO.md file?

Automating task selection from a TODO.md file involves evaluating task priorities and declared dependencies to atomically claim the next executable item, preventing race conditions across concurrent sessions.

How does dependency-aware task execution work in a markdown todo list?

Dependency-aware task execution validates declared dependencies within the TODO.md file, ensuring a task is only selected and marked in-progress after all its prerequisite dependencies are fully resolved.

Can I prevent race conditions when multiple sessions execute tasks from the same TODO.md?

Preventing race conditions with multiple sessions executing tasks from the same TODO.md is achieved through an atomic claiming mechanism that immediately marks the selected task as in-progress.

What is the best way to manage task priority and workflow automation for project development?

Managing task priority and workflow automation is best handled by using a project-root TODO.md as the single source of truth, automatically triaging and executing tasks based on priority levels.

Do I need explicit triggers to start workflow automation on my TODO list?

Explicit triggers are required to start workflow automation on your TODO list, meaning the skill needs a direct invocation prompt like 'work on todo' to begin picking and claiming tasks.