TODO Archive

If these instructions are already present in the conversation from a slash or dollar invocation, follow them directly; do not invoke this skill again through a skill tool.

TODO.md and .ai/ are conventionally git-ignored, so they are untracked and git diff shows nothing for them. Inspect changes against the filesystem, not git.

Arguments

• path (optional): Repository root or any path inside the repository. Default to the current directory.
• --hint TEXT (optional): Archive only the section whose heading contains TEXT (case-insensitive substring), including its subsections. Without it, archive checked tasks from the whole file. Checked tasks outside the matched section stay in TODO.md.
• --date YYYY-MM-DD|YYYY_MM_DD (optional): Archive date. Default to today's local date.
• --dry-run (optional): Preview target paths and rendered content without writing.

Workflow