← Back to Skills Marketplace
bastos

topydo

by Tiago Bastos · GitHub ↗ · v1.0.5
cross-platform ✓ Security Clean
2707
Downloads
2
Stars
3
Active Installs
6
Versions
Install in OpenClaw
/install 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.
Usage Guidance
This skill is just documentation for using the topydo CLI and is internally consistent with that purpose. Before following its install suggestions: 1) verify the topydo package/source (homepage or repository) — the skill metadata doesn't include one; 2) prefer installing from trusted package sources (official brew formula, PyPI package with a known maintainer) and inspect the package if you have doubts; 3) be aware topydo will read/write files like ~/todo.txt, ~/.topydo, and /etc/topydo.conf and may open your editor or create output files (e.g., deps.png) — back up sensitive todo data if needed; 4) avoid running pip install commands with sudo unless you trust the package; 5) if you want higher assurance, inspect the topydo project's source repository before installing. Overall the skill is coherent with its stated purpose, but verify upstream before executing installs.
Capability Analysis
Type: OpenClaw Skill Name: topydo Version: 1.0.5 The OpenClaw AgentSkills skill bundle for 'topydo' is benign. The `SKILL.md` file provides clear, descriptive instructions for installing and using the `topydo` CLI tool for managing todo.txt tasks. All commands demonstrated are standard interactions with the `topydo` utility or common package managers for installation (brew, pip, apt). There is no evidence of data exfiltration, malicious execution, persistence mechanisms, obfuscation, or prompt injection attempts against the AI agent. The content is entirely aligned with the stated purpose of a task management tool.
Capability Assessment
Purpose & Capability
The name/description (topydo CLI for todo.txt) matches the runtime instructions: commands for add/ls/do/pri/tag/dep/etc. There are no unrelated credentials or binaries requested.
Instruction Scope
Instructions tell the agent (user) to run the topydo CLI and to read/edit todo config and todo files (e.g., ~/.topydo, ~/todo.txt, /etc/topydo.conf). This is expected for a task manager but does mean the skill will operate on user files and may open an editor or write archive files.
Install Mechanism
The skill is instruction-only (no install spec). It suggests standard install methods (brew, pip, apt). That is low-risk for the skill itself, but installing third-party packages via pip/brew should be verified because the skill's registry entry lacks a homepage or source URL.
Credentials
No environment variables or credentials are requested. The instruction set references local config paths and the user’s todo files (appropriate for purpose).
Persistence & Privilege
always is false and the skill is user-invocable; it does not request persistent system privileges or modify other skills. Normal autonomous invocation is allowed by platform defaults.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install topydo
  3. After installation, invoke the skill by name or use /topydo
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.5
- Updated skill metadata to include author and version info; moved requirements into the description. - No functional skill changes detected.
v1.0.4
- Updated skill metadata to include author and version info; moved requirements into the description. - No functional skill changes detected.
v1.0.3
- Added suggestion: use a clean, human-readable format to present results to the user.
v1.0.2
- Documentation reorganized for better clarity and concise reference. - Example commands updated and grouped by use case. - Installation and configuration sections streamlined and re-ordered. - Task format, fields, and tips moved to prominent locations for quick reference. - Redundant details trimmed; steps and options presented in a more direct style.
v1.0.1
Version 1.0.1 - fix typo
v1.0.0
Initial release with comprehensive CLI support for managing todo.txt tasks. - Add, list, complete, prioritize, tag, and organize tasks using the topydo CLI. - Full support for dependencies, due/start dates, recurrence, projects, and custom tags. - Installation instructions for pip, Homebrew, and apt. - Detailed usage examples and workflows for common task management scenarios. - Includes advanced features such as sorting, filtering, grouping, and visualizing dependencies. - Compatible with macOS, Linux, and Windows (requires Python 3 and pip).
Metadata
Slug topydo
Version 1.0.5
License
All-time Installs 3
Active Installs 3
Total Versions 6
Frequently Asked Questions

What is topydo?

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. It is an AI Agent Skill for Claude Code / OpenClaw, with 2707 downloads so far.

How do I install topydo?

Run "/install topydo" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is topydo free?

Yes, topydo is completely free (open-source). You can download, install and use it at no cost.

Which platforms does topydo support?

topydo is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created topydo?

It is built and maintained by Tiago Bastos (@bastos); the current version is v1.0.5.

💬 Comments