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.