A local SQLite-backed task management system that persists work items, progress, and summaries directly from AI agent interactions.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install todo-list-pro
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-list-pro 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 List Skill?
The Todo List skill provides a robust framework for tracking local work items or report progress without relying on volatile chat context. By leveraging a local SQLite database, it ensures that your tasks, planned work, and completion statuses remain accessible across different sessions and reboots.
Built for developers and power users, this skill allows an AI agent to act as a structured personal assistant. It bridges the gap between natural language requests and deterministic data storage, enabling Openclaw Skills to handle complex workflows like incremental progress updates, archiving historical data, and generating comprehensive work summaries.
Todo List Skill Use Cases
- Tracking daily development tasks and bug fixes without losing state between chat sessions.
- Maintaining a persistent record of weekly progress for automated work report generation.
- Managing multi-step tasks where progress is updated incrementally over several hours or days.
- Archiving completed work into a terminal history for long-term productivity auditing.
- Reducing cognitive load by offloading task memory to a structured local database.
How Todo List Skill Works
- The user provides a natural language command to add, update, or query a task.
- The AI agent parses the intent and maps it to a specific command for the todo_list.py script.
- The script interacts with the local SQLite database located at ~/.work_report_summary/todo_list.db.
- Tasks are managed through a lifecycle of: Planned -> In Progress -> Completed -> Archived.
- The agent utilizes the --json flag to receive structured feedback from the CLI for follow-up actions.
- For destructive actions like permanent deletion, the system triggers a mandatory confirmation flow to ensure data integrity.
Todo List Skill Setup
To integrate this into your environment, ensure you have Python installed and follow these steps:
# The skill uses a default database path, but you can override it
export TODO_LIST_DB_PATH="/path/to/your/custom/todo.db"
# Initialize or check the list using the Python script
python scripts/todo_list.py --json list --status active
No complex external dependencies are required as it utilizes standard Python libraries and SQLite for local storage.
Todo List Skill Data Schema & Taxonomy
The skill organizes data within a SQLite schema to maintain high relational integrity for Openclaw Skills users:
| Field | Description |
|---|---|
| ID | Unique integer identifier for each task. |
| Title | The primary name or headline of the work item. |
| Planned Amount | Quantitative goal (e.g., 3 sections, 100%). |
| Progress | Current increment of work completed. |
| Status | Current state: Active, Completed, or Archived. |
| Details | Additional context or notes regarding the task. |
| Metadata | Timestamps for creation, updates, and archiving. |
Todo List Skill Advanced Features
- Multi-agent support: Allows different agents to read from and write to the same shared SQLite task database.
- Automated Archiving: Batch move all completed items to history with a single --all-completed command.
- Quantitative Tracking: Support for custom units (e.g., sections, steps, percentages) to measure granular progress.
- JSON Interoperability: Native JSON output for seamless integration with other scripts or automation pipelines.
- Safety Hooks: Built-in confirmation requirements for delete operations to prevent accidental data loss.
SKILL.md
Loading
Related Openclaw Skills
Pop Music AI Concert Agent
An AI-native concert platform where agents process pop music through equations, harmonic separation, and real-time data streaming.
A-Share Guard
A multi-layered financial risk diagnosis system for A-shares that combines quantitative auditing with real-time sentiment analysis to detect market traps.
Financial Risk Scanner
An automated auditing tool that scans Chinese A-share financial statements for 21 distinct risk indicators to identify potential fraud and accounting red flags.
Pop Music
A high-fidelity musical analysis skill that streams 29 layers of pop music data to AI agents for cognitive benchmarking.
Create Teammate Skill
An automated pipeline to distill a colleague's technical skills and personality into a persistent AI agent skill.
ClawCost
ClawCost is a comprehensive financial monitoring tool designed to track API expenditures and optimize model usage for Openclaw Skills.
Featured*
