Agent skill

Topydo

by sundial-org in sundial-org/awesome-openclaw-skills

Manage todo.txt tasks using topydo CLI. An agent skill from sundial-org/awesome-openclaw-skills.

MITAuto-check: notesProductivity & Automation

Install Topydo

skills CLI

$ npx skills add sundial-org/awesome-openclaw-skills --skill topydo -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI

$ gh skill install sundial-org/awesome-openclaw-skills topydo --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy

$ git clone --depth 1 https://github.com/sundial-org/awesome-openclaw-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/topydo .claude/skills/topydo && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Paste into Claude Code

Install the "topydo" agent skill from https://github.com/sundial-org/awesome-openclaw-skills/tree/main/skills/topydo into .claude/skills/topydo/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "topydo", then confirm the skill loads.

Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

$skill-installer

$skill-installer install https://github.com/sundial-org/awesome-openclaw-skills/tree/main/skills/topydo

Type this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.

skills CLI

$ npx skills add sundial-org/awesome-openclaw-skills --skill topydo -a codex

Project install goes to .agents/skills/; add -g for ~/.codex/skills/.

GitHub CLI

$ gh skill install sundial-org/awesome-openclaw-skills topydo --agent codex

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/sundial-org/awesome-openclaw-skills.git skills-src && mkdir -p .agents/skills && cp -r skills-src/skills/topydo .agents/skills/topydo && rm -rf skills-src

Use ~/.agents/skills/ instead of .agents/skills for a personal install.

Codex skills documentation · loads skills from .agents/skills/

Paste into Codex

Install the "topydo" agent skill from https://github.com/sundial-org/awesome-openclaw-skills/tree/main/skills/topydo into .agents/skills/topydo/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "topydo", then confirm the skill loads.

Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add sundial-org/awesome-openclaw-skills --skill topydo -a cursor

Project install goes to .agents/skills/; add -g for ~/.cursor/skills/.

GitHub CLI

$ gh skill install sundial-org/awesome-openclaw-skills topydo --agent cursor

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/sundial-org/awesome-openclaw-skills.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/skills/topydo .cursor/skills/topydo && rm -rf skills-src

Use ~/.cursor/skills/ instead of .cursor/skills for a personal install.

Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/

Paste into Cursor

Install the "topydo" agent skill from https://github.com/sundial-org/awesome-openclaw-skills/tree/main/skills/topydo into .cursor/skills/topydo/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "topydo", then confirm the skill loads.

Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

gemini skills install

$ gemini skills install https://github.com/sundial-org/awesome-openclaw-skills.git --path skills/topydo

--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.

skills CLI

$ npx skills add sundial-org/awesome-openclaw-skills --skill topydo -a gemini-cli

Project install goes to .agents/skills/; add -g for ~/.gemini/skills/.

GitHub CLI

$ gh skill install sundial-org/awesome-openclaw-skills topydo --agent gemini-cli

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/sundial-org/awesome-openclaw-skills.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/skills/topydo .gemini/skills/topydo && rm -rf skills-src

Use ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.

Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/

Paste into Gemini CLI

Install the "topydo" agent skill from https://github.com/sundial-org/awesome-openclaw-skills/tree/main/skills/topydo into .gemini/skills/topydo/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "topydo", then confirm the skill loads.

Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

GitHub CLI

$ gh skill install sundial-org/awesome-openclaw-skills topydo

Installs for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).

skills CLI

$ npx skills add sundial-org/awesome-openclaw-skills --skill topydo -a github-copilot

Project install goes to .agents/skills/; add -g for ~/.copilot/skills/.

Manual copy

$ git clone --depth 1 https://github.com/sundial-org/awesome-openclaw-skills.git skills-src && mkdir -p .github/skills && cp -r skills-src/skills/topydo .github/skills/topydo && rm -rf skills-src

Use ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.

GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/

Paste into GitHub Copilot

Install the "topydo" agent skill from https://github.com/sundial-org/awesome-openclaw-skills/tree/main/skills/topydo into .github/skills/topydo/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "topydo", then confirm the skill loads.

GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add sundial-org/awesome-openclaw-skills --skill topydo -a opencode

OpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.

GitHub CLI

$ gh skill install sundial-org/awesome-openclaw-skills topydo --agent opencode

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/sundial-org/awesome-openclaw-skills.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/skills/topydo .opencode/skills/topydo && rm -rf skills-src

Use ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.

OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/

Paste into OpenCode

Install the "topydo" agent skill from https://github.com/sundial-org/awesome-openclaw-skills/tree/main/skills/topydo into .opencode/skills/topydo/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "topydo", then confirm the skill loads.

OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

Facts

Skill name: topydo
GitHub stars: 663
Token cost: ~1.7k tokens
SKILL.md length: 407 words
Files: 1
Skills in repo: 383
Repo updated: Mar 7, 2026
First seen: Oct 9, 2026
Licence: MIT

At a glance

Manage todo.txt tasks using topydo CLI. An agent skill from sundial-org/awesome-openclaw-skills.

Any task management
SKILL.md covers Task Format Reference, Installation, Configuration and Adding Tasks, plus 12 more sections
Calls pip3, brew and apt
The user mentions tasks

What it does

Topydo is an agent skill from sundial-org/awesome-openclaw-skills. Manage todo.txt tasks using topydo CLI. Add, list, complete, prioritize, tag, and organize tasks with dependencies, due dates, recurrence, and projects. Use for any task management, todo lists, or when the user mentions tasks, todos, or todo.txt. Requires Python 3 and pip. Works on macOS, Linux, and Windows.

Its SKILL.md is about 1.7k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Productivity & Automation, covering Task management. It works with macOS, Python and Linux. The repository describes itself as: Top OpenClaw skills, with the most popular and useful ones. The licence is MIT.

When your agent uses it

Any task management
The user mentions tasks

Example prompts

“/topydo”

Requirements

Python 3

What it can do on your machine

Read from SKILL.md and the folder at commit b80cde2. It shows what the files ask for, not the result of running them.

Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
Shell commands in SKILL.md call:
- pip3
- brew
- apt
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md. Its commands use pip3, which can reach the network depending on how they are called.
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Topydo loads about 1.7k tokens when it runs. Until then it costs about 79 tokens; SKILL.md has 407 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it: ~79
When it runs · the whole SKILL.md, loaded when a task matches: ~1.7k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

NoteRuns commands with sudoSKILL.md:49

sudo apt install python3-pip && pip3 install topydo

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from sundial-org/awesome-openclaw-skills at commit b80cde2, republished under its MIT licence (© sundial-org). 407 words, ~1,657 tokens.

Download SKILL.mdSave it as .claude/skills/topydo/SKILL.md (or your agent's skills folder).

name: topydo
description: Manage todo.txt tasks using topydo CLI. Add, list, complete, prioritize, tag, and organize tasks with dependencies, due dates, recurrence, and projects. Use for any task management, todo lists, or when the user mentions tasks, todos, or todo.txt. Requires Python 3 and pip. Works on macOS, Linux, and Windows.
license: MIT
metadata.author: github.com/bastos
metadata.version: 2.0

topydo - Todo.txt Task Manager

topydo is a powerful CLI for managing tasks in the todo.txt format. It supports dependencies, due dates, start dates, recurrence, priorities, projects, and contexts.

Task Format Reference

(A) 2025-01-11 Task text +Project @Context due:2025-01-15 t:2025-01-10 rec:1w star:1
│   │          │         │        │        │             │            │      │
│   │          │         │        │        │             │            │      └─ Star marker
│   │          │         │        │        │             │            └─ Recurrence
│   │          │         │        │        │             └─ Start/threshold date
│   │          │         │        │        └─ Due date
│   │          │         │        └─ Context
│   │          │         └─ Project
│   │          └─ Task description
│   └─ Creation date
└─ Priority (A-Z)

Installation

Homebrew (macOS, preferred)

bash

brew install topydo

pip (all platforms)

bash

pip3 install topydo

With optional features:

bash

pip3 install 'topydo[columns,prompt,ical]'

apt (Ubuntu/Debian)

bash

sudo apt install python3-pip && pip3 install topydo

Configuration

Config file locations (in order of precedence):

topydo.conf or .topydo (current directory)
~/.topydo or ~/.config/topydo/config
/etc/topydo.conf

Example ~/.topydo:

ini

[topydo]
filename = ~/todo.txt
archive_filename = ~/done.txt
colors = 1
identifiers = text

[add]
auto_creation_date = 1

[sort]
sort_string = desc:importance,due,desc:priority
ignore_weekends = 1

Adding Tasks

Basic task:

bash

topydo add "Buy groceries"

With priority (A is highest):

bash

topydo add "(A) Urgent task"

With project and context:

bash

topydo add "Write report +ProjectX @office"

With due date (absolute):

bash

topydo add "Submit proposal due:2025-01-15"

With due date (relative):

bash

topydo add "Call mom due:tomorrow"

With due date (weekday):

bash

topydo add "Weekly review due:fri"

With start/threshold date:

bash

topydo add "Future task t:2025-02-01"

With recurrence (weekly):

bash

topydo add "Water plants due:sat rec:1w"

With strict recurrence (always on 1st of month):

bash

topydo add "Pay rent due:2025-02-01 rec:+1m"

With dependency (must complete before task 1):

bash

topydo add "Write tests before:1"

As subtask of task 1:

bash

topydo add "Review code partof:1"

Listing Tasks

List all relevant tasks:

bash

topydo ls

Include hidden/blocked tasks:

bash

topydo ls -x

Filter by project:

bash

topydo ls +ProjectX

Filter by context:

bash

topydo ls @office

Filter by priority:

bash

topydo ls "(A)"

Filter by priority range:

bash

topydo ls "(>C)"

Filter tasks due today:

bash

topydo ls due:today

Filter overdue tasks:

bash

topydo ls "due:<today"

Filter tasks due by Friday:

bash

topydo ls "due:<=fri"

Combine multiple filters:

bash

topydo ls +ProjectX @office due:today

Exclude context:

bash

topydo ls -- -@waiting

Sort by priority:

bash

topydo ls -s priority

Sort descending by due date, then priority:

bash

topydo ls -s desc:due,priority

Group by project:

bash

topydo ls -g project

Limit to 5 results:

bash

topydo ls -n 5

Custom output format:

bash

topydo ls -F "%I %p %s %{due:}d"

Output as JSON:

bash

topydo ls -f json

Completing Tasks

Complete task by ID:

bash

topydo do 1

Complete multiple tasks:

bash

topydo do 1 2 3

Complete all tasks due today:

bash

topydo do -e due:today

Complete with custom date:

bash

topydo do -d yesterday 1

Priority Management

Set priority A:

bash

topydo pri 1 A

Set priority for multiple tasks:

bash

topydo pri 1 2 3 B

Remove priority:

bash

topydo depri 1

Tagging Tasks

Set due date:

bash

topydo tag 1 due tomorrow

Star a task:

bash

topydo tag 1 star 1

Remove a tag:

bash

topydo tag 1 due

Set custom tag with relative date:

bash

topydo tag -r 1 review 2w

Modifying Tasks

Append text to task:

bash

topydo append 1 "additional notes"

Append due date:

bash

topydo append 1 due:friday

Edit task in text editor:

bash

topydo edit 1

Edit all tasks in project:

bash

topydo edit -e +ProjectX

Show full SKILL.md (166 more words)Show less

Deleting Tasks

Delete by ID:

bash

topydo del 1

Delete multiple:

bash

topydo del 1 2 3

Delete by expression:

bash

topydo del -e completed:today

Dependencies

Add dependency (task 2 depends on task 1):

bash

topydo dep add 2 to 1

Task 2 is part of task 1:

bash

topydo dep add 2 partof 1

List what depends on task 1:

bash

topydo dep ls 1 to

List what task 1 depends on:

bash

topydo dep ls to 1

Remove dependency:

bash

topydo dep rm 2 to 1

Visualize dependencies (requires graphviz):

bash

topydo dep dot 1 | dot -Tpng -o deps.png

Postponing Tasks

Postpone by 1 week:

bash

topydo postpone 1 1w

Postpone by 3 days:

bash

topydo postpone 1 3d

Postpone including start date:

bash

topydo postpone -s 1 1w

Other Commands

Sort the todo.txt file:

bash

topydo sort

Revert last command:

bash

topydo revert

Show revert history:

bash

topydo revert ls

List all projects:

bash

topydo lsprj

List all contexts:

bash

topydo lscon

Archive completed tasks:

bash

topydo archive

Relative Dates

today, tomorrow, yesterday
Weekdays: mon, tue, wed, thu, fri, sat, sun
Periods: 1d (days), 2w (weeks), 3m (months), 1y (years)
Business days: 5b (excludes weekends)

Sort/Group Fields

priority, due, creation, completed
importance, importance-avg
project, context, text, length

Prefix with desc: for descending. Example: desc:importance,due

Tips

Use a clean, human-readable format to present results to the user
Enable stable text IDs: set identifiers = text in config
Star important tasks: add star:1 tag
Hidden tags by default: id, p, ical
Importance = priority + due date proximity + star status

Files

Just SKILL.md in skills/topydo of sundial-org/awesome-openclaw-skills.

Open the folder on GitHubat commit b80cde2

Compare with similar skills

Topydo next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Topydo compared with similar skills
Skill	Stars	Used in	Tokens	Auto-check	Licence	Repo updated
Topydo this skillsundial-org/awesome-openclaw-skills	663	—	~1.7k	Automated safety check: Notes	MIT	7 mo ago
Browser MCP Agentantibrow/anti-detect-browser-skills	17	1 repos	~4.2k	Automated safety check: Warn	MIT	1 mo ago
Env Doctorcat-xierluo/legal-skills	720	—	~756	Automated safety check: Pass	MIT	today
A2a ProtocolTerminalSkills/skills	163	—	~2.8k	Automated safety check: Pass	Apache-2.0	6 days ago
Fantastical Calendartwhsi/skills	259	—	~688	Automated safety check: Pass	None	2 mo ago
Apple Container Test RunnerRustPython/RustPython	22k	—	~467	Automated safety check: Pass	MIT	today

Similar skills

Browser MCP Agent
antibrow/anti-detect-browser-skills
Give an AI agent its own real browser over MCP tool calls - launch, navigate, click, fill, screenshot, extract text, run JS - with a kernel-level real-device fingerprint and a persistent profile, so…
17 GitHub starsUsed in 1 repo~4.2k tokens
Productivity & AutomationAuto-check: warnings
Env Doctor
cat-xierluo/legal-skills
本机开发环境与全局包的体检、账本与安装纪律，覆盖所有包管理器（npm/npx、nvm、pip/pipx、uv、brew、bun）与运行时环境面（~/.local/bin 垫片、PATH、python 解释器版图、LaunchAgents、cron、shell rc 漂移对照）。当用户问「node/python 为什么是这个版本」「npm/pip…
720 GitHub stars~756 tokensUpdated today
Productivity & AutomationAuto-check passed
A2a Protocol
TerminalSkills/skills
Builds Agent2Agent (A2A) servers and clients, the open protocol (originally from Google, now under the Linux Foundation) that lets AI agents from different frameworks call each other.
163 GitHub stars~2.8k tokensUpdated 6 days ago
Productivity & AutomationAuto-check passed
Fantastical Calendar
twhsi/skills
Turns scheduling requests into Fantastical events or reminders on macOS, previewing the parsed item in the app first and adding it only when you confirm.
259 GitHub stars~688 tokensUpdated 2 mo ago
Productivity & AutomationAuto-check passed
Apple Container Test Runner
RustPython/RustPython
Runs RustPython tests inside a Linux container built with Apple's container CLI, so macOS users can compare Linux results with their local ones.
22k GitHub stars~467 tokensUpdated today
Testing & QAAuto-check passed
Remote Hosts
libnativeapi/nativeapi
Build, run, and GUI-test on another machine over SSH — the user's Windows laptop today, Linux or other macOS machines tomorrow — with one symmetric CLI for every OS: push scripts, run them either in…
164 GitHub stars~1.3k tokensUpdated today
MobileAuto-check passed

Questions about Topydo

What does Topydo do?

Manage todo.txt tasks using topydo CLI. An agent skill from sundial-org/awesome-openclaw-skills. Topydo is an agent skill from sundial-org/awesome-openclaw-skills.txt tasks using topydo CLI.

When should I use Topydo?

Topydo fits situations like: any task management; the user mentions tasks.

How do I install Topydo in Claude Code?

Run `npx skills add sundial-org/awesome-openclaw-skills --skill topydo -a claude-code`. Or copy the skill folder (skills/topydo in sundial-org/awesome-openclaw-skills) into .claude/skills/topydo in your project. Claude Code loads it when a task matches its description.

How do I install Topydo in Codex?

Run `npx skills add sundial-org/awesome-openclaw-skills --skill topydo -a codex`. Or copy the skill folder (skills/topydo in sundial-org/awesome-openclaw-skills) into .agents/skills/topydo in your project. Codex loads it when a task matches its description.

Can I use Topydo in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add sundial-org/awesome-openclaw-skills --skill topydo -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/topydo, .gemini/skills/topydo, .github/skills/topydo and .opencode/skills/topydo in your project.

What does Topydo need to run?

Going by SKILL.md and its folder, Topydo needs the command-line tools its instructions call (pip3, brew and apt). Our summary lists: Python 3.

Does Topydo access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Topydo safe to install?

Our automated static check of SKILL.md found notes only (runs commands with sudo), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.

What licence does Topydo use?

Topydo is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Topydo use?

About 1.7k tokens (SKILL.md is roughly 6.6k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Topydo?

Skills that share tags, products or a category with Topydo: Browser MCP Agent (antibrow/anti-detect-browser-skills, 17 stars), Env Doctor (cat-xierluo/legal-skills, 720 stars), A2a Protocol (TerminalSkills/skills, 163 stars) and Fantastical Calendar (twhsi/skills, 259 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Topydo?

sundial-org (a GitHub organization) maintains it in sundial-org/awesome-openclaw-skills, which has 663 GitHub stars. The repository holds 383 skills in this directory. The repository was last updated on March 7, 2026.

Source: sundial-org/awesome-openclaw-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.

Install Topydo

Facts

At a glance

What it does

When your agent uses it

Example prompts

Requirements

What it can do on your machine

Tool permissions

Runs code

Network

Credentials

Context cost

Safety

SKILL.md

topydo - Todo.txt Task Manager

Task Format Reference

Installation

Homebrew (macOS, preferred)

pip (all platforms)

apt (Ubuntu/Debian)

Configuration

Adding Tasks

Listing Tasks

Completing Tasks

Priority Management

Tagging Tasks

Modifying Tasks

Deleting Tasks

Dependencies

Postponing Tasks

Other Commands

Relative Dates

Sort/Group Fields

Tips

Files

Compare with similar skills

Similar skills

More from sundial-org/awesome-openclaw-skills

Related

Questions about Topydo