← 返回 Skills 市场

Easy TODO list management for busy crustaceans and their humans

Name: Easy TODO list management for busy crustaceans and their humans
Author: simenfur

作者 simenfur · GitHub ↗ · v1.0.0 · MIT-0

cross-platform ✓ 安全检测通过

284

总下载

当前安装

版本数

在 OpenClaw 中安装

/install easy-todo

功能描述

Personal TODO list manager. Add tasks with deadlines and priorities, mark them done, set up recurring items, and receive morning and evening summaries.

使用说明 (SKILL.md)

TODO Skill

You manage the user's personal TODO list. All tasks are persisted in ~/.openclaw/skills/todo/todos.md.

Running the CLI

node ~/.openclaw/skills/todo/cli.js \x3Ccommand> [options]

The file creates todos.md in the same directory automatically on first run.

Commands

add "\x3Ctitle>" [--due YYYY-MM-DD] [--priority high|medium|low] [--notes "..."] [--tags tag1,tag2]
complete \x3Cid-or-title>
cancel \x3Cid-or-title>
list
list --today
list --upcoming [--days N]
list --completed
list --recurring
add-recurring "\x3Ctitle>" --frequency daily|weekly|monthly-first|monthly-last [--priority high|medium|low]
add-recurring "\x3Ctitle>" --days mon,wed,fri [--priority high|medium|low]
briefing morning
briefing evening
materialize

All commands print plain text. Exit 0 = success.

Handling user messages

Adding a task

Extract the title.
If no due date was mentioned, ask for one before running the command — unless the user explicitly said "no deadline" or "no due date".
Map urgency to priority: "urgent" / "ASAP" → high; "whenever" / "no rush" → low; otherwise medium.
Run add and relay the output.

Completing a task

Match "done", "finished", "completed", "ticked off", etc. Use the task ID (T3) or a title fragment with complete.

Recurring tasks

Confirm frequency if ambiguous:

"every day" / "daily" → --frequency daily
"every Monday" / "weekly" → --frequency weekly
"first of the month" → --frequency monthly-first
"end of the month" / "last day" → --frequency monthly-last
"every Tuesday and Thursday" / "Mon, Wed, Fri" / any specific days → --days tue,thu

For --days, accepted formats: full names (monday), three-letter abbreviations (mon), or numbers (1 for Monday). Multiple days are comma-separated. Examples:

"every weekday" → --days mon,tue,wed,thu,fri
"Tuesdays and Thursdays" → --days tue,thu
"every weekend" → --days sat,sun

Scheduled reminders

Run these automatically on the following schedule, without waiting for the user to ask:

Time	Command	What to send
08:30	`briefing morning`	Morning overview: overdue, due today, upcoming 7 days
18:00	`briefing evening`	Evening check-in: tasks still open today

Also run materialize once per day (e.g. at 00:05 or alongside the morning briefing) to convert any due recurring tasks into active items before the briefing runs.

todos.md

The file is managed entirely by cli.js — never edit it by hand. It contains a JSON block (machine-readable) and Markdown tables (human-readable) that are regenerated on every write.

安全使用建议

This skill is broadly coherent with its purpose (a simple local TODO CLI) and does not ask for secrets or network access. Before installing, consider: 1) Where will the script live? SKILL.md says ~/.openclaw/skills/todo/todos.md but the code writes todos.md next to cli.js by default — set TODOS_FILE or place the script in the intended directory so you know where data is stored. 2) The skill asks the agent to run scheduled briefings automatically — confirm you want the agent to run the skill on a schedule (it will read/write your todos file and output task summaries). 3) The included cli.js appears to be standalone and dependency-free, but the provided file preview is truncated and contains what looks like a coding bug (an incomplete reference like readStore().tas in the truncated area). Review the full cli.js for typos or runtime errors before trusting it with important data, and test it in a safe environment. If you want stronger guarantees, inspect the full script file for hidden network calls (none are visible here) and adjust the TODOS_FILE env var to a location you control.

功能分析

Type: OpenClaw Skill Name: easy-todo Version: 1.0.0 The skill is a standard TODO list manager that persists tasks in a local Markdown file (`todos.md`). The Node.js implementation (`cli.js`) contains no external dependencies, network calls, or shell execution, and the instructions in `SKILL.md` are strictly focused on task management and scheduling without any signs of prompt injection or malicious intent.

能力评估

ℹ Purpose & Capability

The skill's stated purpose (local TODO manager) matches the included code (cli.js) and required binary (node). However, SKILL.md says tasks are persisted in ~/.openclaw/skills/todo/todos.md while cli.js defaults to writing todos.md next to the script (__dirname). This mismatch may cause surprises about where data is stored.

ℹ Instruction Scope

SKILL.md instructs the agent to run the CLI and to ask follow-up questions for missing due dates — that is appropriate. It also directs the agent to run scheduled commands automatically (morning/evening briefings and a daily materialize) 'without waiting for the user to ask.' That grants the agent recurring autonomous activity related to this skill; it's coherent with the feature but worth confirming you want autonomous scheduled runs. The README instructs 'never edit todos.md by hand' and indicates cli.js manages the file, which is consistent.

✓ Install Mechanism

No install spec; this is an instruction-only skill with a single script file. The script is plain Node.js with no external network downloads or package installs — low risk from the install mechanism.

✓ Credentials

The skill declares no required environment variables or credentials. The CLI optionally respects a TODOS_FILE env var for custom storage location, which is reasonable and limited in scope.

ℹ Persistence & Privilege

always:false (normal). The SKILL.md requests the agent run scheduled briefings automatically; to achieve that the agent will need permission to invoke the skill on a schedule. This increased autonomous activity is coherent with the feature but raises the usual concern about unattended periodic execution (reads/writes the local todos file and emits summaries).

如何使用

确保已安装 OpenClaw（本地或 Docker 部署）
在对话框中输入安装命令：/install easy-todo
安装完成后，直接呼叫该 Skill 的名称或使用 /easy-todo 触发
根据 Skill 的参数说明提供必要输入，即可获得结构化输出

版本历史

v1.0.0

- Initial release of easy-todo, a personal TODO list manager. - Add, complete, cancel, and list tasks with optional deadlines, priorities, notes, and tags. - Support for recurring tasks with flexible scheduling (daily, weekly, monthly, specific days). - Automated morning and evening briefings summarize tasks and reminders. - All tasks are saved in a local todos.md file; operated by command-line interface. - Scheduled commands run automatically for daily maintenance and summaries.

元数据

Slug easy-todo

版本 1.0.0

许可证 MIT-0

累计安装 0

当前安装数 0

历史版本数 1

常见问题