← Back to Skills Marketplace
xejrax

Tasks

by Xejrax · GitHub ↗ · v1.0.0
cross-platform ⚠ suspicious
1873
Downloads
1
Stars
5
Active Installs
1
Versions
Install in OpenClaw
/install brainz-tasks
Description
Manage Todoist tasks using the `todoist` CLI. Add, list, and complete tasks from the command line.
README (SKILL.md)

Tasks Skill

Wraps Todoist / Microsoft To-Do APIs to add, list, and complete tasks. Requires TODOIST_API_TOKEN or MSGRAPH_TOKEN env var.

Listing Tasks

Show all pending tasks:

todoist list

Adding Tasks

Create a new task with an optional due date:

todoist add "Review PR #42" --due "2026-02-05"

Completing Tasks

Mark a task as done:

todoist complete \x3Ctask_id>

Install

pip install todoist-api-python
Usage Guidance
Proceed with caution. Before installing or enabling this skill: (1) Ask the publisher to update the skill metadata to declare exactly which environment variable(s) it needs (TODOIST_API_TOKEN and/or MSGRAPH_TOKEN). Do not set sensitive tokens until you confirm they are required and why. (2) Verify that the pip package 'todoist-api-python' actually provides a 'todoist' CLI (check the package's PyPI/GitHub page and its console_scripts entry points); if it does not, the install step will not provide the binary the skill expects. (3) If you must test, do so in a sandboxed environment and use least-privilege test tokens (revocable API tokens). (4) If the skill claims to support Microsoft To‑Do, confirm exactly what permissions the MSGRAPH_TOKEN requires — Microsoft Graph scopes can grant broad access to mailbox and files. (5) Prefer skills whose required credentials are declared in metadata and whose install source is a well-known project URL you can inspect. If the author cannot clarify these mismatches, avoid installing.
Capability Analysis
Type: OpenClaw Skill Name: brainz-tasks Version: 1.0.0 The skill bundle is benign. It provides instructions and metadata for an OpenClaw agent to manage Todoist tasks using the `todoist` CLI. The `SKILL.md` file clearly outlines the skill's purpose, installation steps via pip for `todoist-api-python`, and usage examples. It legitimately requires `TODOIST_API_TOKEN` or `MSGRAPH_TOKEN` environment variables for authentication, which is expected for an API-driven task management tool. There is no evidence of data exfiltration, malicious execution, persistence mechanisms, or prompt injection attempts with harmful intent. All instructions and dependencies are aligned with the stated functionality.
Capability Assessment
Purpose & Capability
The skill claims to 'Manage Todoist tasks' and mentions Microsoft To‑Do, which would legitimately require TODOIST_API_TOKEN or MSGRAPH_TOKEN; however the registry metadata lists no required environment variables and only requires a 'todoist' binary. That omission is inconsistent: a task-management integration normally needs one API token declared as a required credential.
Instruction Scope
SKILL.md instructs the agent to run CLI commands (todoist list/add/complete) and explicitly references TODOIST_API_TOKEN and MSGRAPH_TOKEN, but those env vars are not declared in the skill metadata. The instructions themselves do not ask the user where to obtain tokens or validate which service (Todoist vs Microsoft) will be used, giving the agent ambiguous leeway to require/expect sensitive tokens.
Install Mechanism
The install spec installs the PyPI package 'todoist-api-python' via pip. That's a plausible client library, but it's unclear whether that package actually installs a console 'todoist' binary as the skill requires; if it doesn't, the declared required binary and the install step are mismatched. Installing from PyPI is moderate risk but expected for a Python-based integration — verify the package and its entry points before running.
Credentials
The runtime docs require TODOIST_API_TOKEN or MSGRAPH_TOKEN (sensitive tokens), but the skill metadata does not declare any required env vars or a primary credential. Requesting both a Todoist token and a Microsoft Graph token is broader than necessary for a single-provider 'Tasks' skill and should be justified. Tokens like these grant access to user task data and are high-sensitivity secrets.
Persistence & Privilege
The skill does not request persistent 'always' inclusion, does not declare config paths, and has no code files that would write to disk. It appears not to request elevated or persistent platform privileges.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install brainz-tasks
  3. After installation, invoke the skill by name or use /brainz-tasks
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial publish
Metadata
Slug brainz-tasks
Version 1.0.0
License
All-time Installs 5
Active Installs 5
Total Versions 1
Frequently Asked Questions

What is Tasks?

Manage Todoist tasks using the `todoist` CLI. Add, list, and complete tasks from the command line. It is an AI Agent Skill for Claude Code / OpenClaw, with 1873 downloads so far.

How do I install Tasks?

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

Is Tasks free?

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

Which platforms does Tasks support?

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

Who created Tasks?

It is built and maintained by Xejrax (@xejrax); the current version is v1.0.0.

💬 Comments