todo-moving
Move selected open todo files from one category folder to another and renumber open todos in both folders.
Purpose
Apply this skill to todo migrations inside the configured todos directory (default: docs/agent-todos/) when number consistency is required.
Arguments
source-category: folder under the todos directory that currently contains the todos, for examplemisctodo-set: comma-separated list of numbers and/or ranges, for example0011-0014,0020target-category: destination folder under the todos directory, for exampleseo
Workflow
- Validate that source category, todo set, and target category are present.
- Run the bundled script:
bash <base_directory>/scripts/move-todos.sh "<project_root>" "<source-category>" "<target-category>" "<todo-set>"
Where:
<base_directory>is the path shown in "Base directory for this skill:" during invocation.<project_root>is the repository root.
- Review script output for moved files, warnings, and renumbering actions.
Todo Set Format
Accept these token formats inside todo-set:
- single number:
0012 - range:
0011-0014 - mixed list:
0011-0014,0018,0021
Move only open markdown todo files matching <number>_*.md.
Renumbering Rules
After moving files, renumber open todos in source and target categories:
- open files:
^[0-9]{4}_.*\.md$ - done files:
^DONE_[0-9]{4}_.*\.md$ - assign open todos to the smallest free numbers from
0001upward - keep numbers used by DONE files reserved
Produce gapless numbering for open todos without DONE collisions.