todo-management

What This Skill Does

The todo-management skill provides a robust, per-workspace task tracking system powered by SQLite. Unlike cloud-based tools that require external dependencies or browser sessions, this skill operates locally within your development environment. By utilizing a specific database file (./todo.db) and a CLI wrapper (todo.sh), it ensures that your task data remains strictly scoped to the workspace context. It supports granular task management, including status tracking (pending, in_progress, done, skipped), organization through groups, and efficient command-line manipulation. This tool is designed for high-velocity environments where context switching must be minimized.

Installation

To add this skill to your workspace, execute the following command in your terminal:

clawhub install openclaw/skills/skills/lstpsche/todo-management

Once installed, ensure your baseDir has access to the scripts/ directory to trigger the CLI commands. The skill will automatically initialize the SQLite database upon the first task creation.

Use Cases

• Development Workflow Tracking: Keep track of specific bugs, feature requests, or technical debt items directly inside your project folder.
• Workspace-Specific Context: Maintain separate to-do lists for different repositories without the clutter of a global task manager.
• Status-Driven Productivity: Use status flags like in_progress to communicate current focus during collaborative sessions.
• Quick-Access Task Management: Perform rapid additions and modifications through the shell, keeping your flow uninterrupted by GUIs.

Example Prompts

1. "Add a task to finish the OAuth integration in the Work group with status in_progress."
2. "Show me all my pending tasks for the current project."
3. "Move task 14 to the 'Backlog' group and mark it as skipped."

Tips & Limitations

• Non-destructive by default: The tool is designed to be safe. It will never output large text files or modify files outside of todo.db.
• Strict CLI Enforcement: All task modifications must flow through the provided script; direct manipulation of the SQLite database via external SQL clients is discouraged to maintain data integrity.
• Automated List Hiding: To keep your terminal clean, the system defaults to hiding completed tasks. Use the --all flag only when a full review is necessary.
• Group Safety: When deleting groups, the system defaults to moving tasks to the Inbox rather than purging them, ensuring you never accidentally lose track of assignments.