todo_list

Use this skill to persist local work items instead of keeping them only in chat context.

Workflow

• - Run commands from {baseDir}/scripts/todo_list.py.
• Store data in ~/.work_report_summary/todo_list.db by default.
• Override the database path with TODO_LIST_DB_PATH only for tests or when the user explicitly wants a different file.
• Prefer --json whenever the command output will be used in a follow-up step.
• Keep completed items visible in active lists until the user asks to archive them.
• Treat archived items as terminal history. Do not update their progress after archiving.
• Use delete only when the user explicitly wants permanent removal. Prefer archive when the user means "move to history".
• Before running delete, ask for one more explicit confirmation from the user. Permanent deletion should be confirmed, not inferred.

Natural-Language Patterns

Map common user requests to the deterministic CLI instead of keeping task state only in conversation memory.

• - Add planned work when the user says things like:

• - Update progress when the user says things like:

• - Mark complete when the user says things like:

• - List or review current work when the user says things like:

• - Summarize when the user says things like:

• - Archive only when the user explicitly asks to archive or move finished work into history:

• - Delete only when the user explicitly asks to permanently remove a task:

• - If the user asks to delete, confirm once more before actually deleting.

When the user does not specify an exact task id, identify the task by title or recent context first, then run the CLI with the resolved id.

Core Commands

• - Add a task:

• - Record progress:

• - Mark a task complete:

• - List active tasks:

• - Archive a task:

• - Archive by exact title:

• - Archive all completed tasks:

• - Delete a task permanently:

• - Delete by exact title:

• - Summarize progress:

References

• - Read {baseDir}/references/commands.md for full CLI shapes and example flows.
• Read {baseDir}/references/chat_reference.md for natural-language examples and intent-to-command mapping.
• Read {baseDir}/references/storage.md when changing the SQLite schema, default path, or environment-variable behavior.