skills/notion-todo/SKILL.md

/home/ubuntu/.openclaw/workspace/skills/notion-todo/SKILL.md

name: notion-todo description: Add tasks to snake's Notion todo database (Tasks Tracker). Use when the user says things like "add X to my todo", "remind me to X", "create a task", or wants a new Notion task with optional due date/priority/category/status.

Notion Todo (TO-DO)

Use the bundled script to create a new task in the Notion TO-DO data source.

Fast path (preferred)

Run:

NOTION_API_KEY="$NOTION_API_KEY" \
python3 skills/notion-todo/scripts/add_todo.py "<task title>" \
  --status "Not started" \
  --due "YYYY-MM-DD" \
  --category "<existing category>" \
  --project "<existing project>" \
  --milestone "<existing milestone>"

The script prints JSON with the created page url.

Notes / guardrails

Target is hardcoded to the TO-DO data source id 23044db7-5011-8074-8af9-000b571c0daf.
Title property is Name.
Status property is Status.
Pass --due as ISO-8601. If the user gives natural language ("tomorrow", "next Friday"), convert it to a date before calling the script.
Optional selects supported: --category, --project, --milestone (must match existing options).
If Notion returns a validation error, query the data source schema (GET /v1/data_sources/<id>) to see allowed options.