A local Python-based task management system using SQLite for persistent, agent-driven TODO tracking.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install todo-master
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install todo-master using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Todo Master?
Todo Master is a specialized local task management tool designed for the Openclaw Skills ecosystem. It allows developers and AI agents to manage TODO items through a robust Python CLI and a SQLite backend. Unlike cloud-dependent services, this skill keeps your data local, ensuring privacy and offline reliability.
The skill provides a stable interface for agents to create, update, and filter tasks based on priority, status, and deadlines. It is built with data longevity in mind, featuring automatic database migrations and legacy data import capabilities to ensure your task history remains intact across version updates.
Todo Master Use Cases
- Maintain local TODO lists within an AI agent environment without external API dependencies.
- Automate daily task creation and reporting via stable Python script entry points.
- Track complex projects with multi-level priorities and specific due dates.
- Manage tasks across Openclaw Skills updates with reliable data persistence.
How Todo Master Works
- The user initializes the skill by defining a data directory, which creates the local SQLite database.
- Tasks are added via the CLI with metadata including title, content, priority (1-5), and optional due dates.
- The agent or user queries tasks using specialized commands like list-today or keyword-based filtering.
- Task status is managed through discrete commands for completion, reopening, or archiving.
- The system automatically handles schema upgrades and data migration to maintain compatibility with new features.
Todo Master Setup
This skill requires Python 3.10 or higher. Use the following commands to install dependencies and initialize the environment:
# Install dependencies
python3 -m pip install -r ./todo-master/requirements.txt
# Initialize with the default data directory
python3 ./todo-master/scripts/todo.py init --default
# Or initialize with a custom absolute path
python3 ./todo-master/scripts/todo.py init --data-dir /path/to/your/data
Todo Master Data Schema & Taxonomy
Todo Master separates configuration from data to ensure smooth upgrades for users of Openclaw Skills.
| File | Purpose |
|---|---|
config.json |
Stores the absolute path to the data directory and database settings. |
todos.sqlite3 |
SQLite database containing the tasks table with schema versioning. |
requirements.txt |
Defines the Python environment dependencies. |
The database schema includes fields for task ID, title, content, priority (integers 1-5), status (open, done, archived), and ISO-formatted due dates.
Todo Master Advanced Features
- SQLite schema migration support using PRAGMA user_version to prevent data loss during updates.
- JSON output flags (--json) for seamless integration with other automated workflows and agents.
- Quick-add commands for today and tomorrow to streamline daily planning.
- Soft-archive capability to maintain history without cluttering active views.
- Comprehensive statistics command to analyze task completion rates and distribution.
SKILL.md
Loading
Related Openclaw Skills
Doubao API Toolkit
A cross-platform Python implementation for Doubao (Volcengine ARK) multi-modal AI services including image and video generation.
Receiving Code Review
A specialized protocol for AI agents to process code review feedback through technical verification rather than social compliance.
PPT Maker
An automated presentation generator that converts Markdown files into professional PPTX slide decks with smart data visualization.
Meta Knowledge Base
A self-building AI knowledge management system that automatically organizes information into a searchable knowledge graph.
Side Project Validator
An AI-driven validation engine that uses data-backed frameworks to determine the feasibility and profitability of side projects and business ideas.
Roo Code
Roo Code is an autonomous AI coding agent for VS Code that executes multi-step tasks, manages files, and integrates with external tools via MCP.
Featured*
