Agent skill · marketing growth · intellectronica
todoist-api
This skill provides instructions for interacting with Todoist using the td CLI tool. It covers CRUD operations for tasks/projects/sections/labels/comments, and requires confirmation before destructive actions. Use this skill when the user wants to read, create, update, or delete Todoist data.
Why this skill is useful
Provides specific commands and usage patterns for the Todoist CLI that the AI wouldn't reliably generate on its own.
What it needs
Requires @doist/todoist-cli installed locally. About 6k tokens when loaded. Last updated 2026-04-25. 281 stars on the source repository.
What this skill does
Todoist CLI Skill This skill provides procedural guidance for working with Todoist using the td CLI tool. Prerequisites The td CLI must be installed and authenticated. Verify with: If td is not installed or not authenticated: Not installed: Tell the user to install with npm install -g @doist/todoist-cli Not authenticated: Tell the user to run td auth login to authenticate via OAuth Output Formats for Agents For machine-readable output, use these flags: --json - Output as JSON array --ndjson - Output as newline-delimited JSON (one object per line) --full - Include all fields in JSON output (default shows essential fields only) Confirmation Requirement Before executing any destructive action, always ask the user for confirmation using AskUserQuestion or similar tool. A single confirmation suffices for a logical group of related actions. Destructive actions include: Deleting tasks, projects, sections, labels, or comments Completing tasks Updating existing resources Archiving projects Read-only operations do not require confirmation. Quick Commands Command Description --------- ------------- td add "text" Quick add with natural language parsing td today Tasks due today and overdue td upcoming [days] Tasks due in next N days (default: 7) td inbox Tasks in Inbox td completed Recently completed tasks Quick Add Examples The quick add parser supports: Due dates: tomorrow, next monday, Jan 15 Priority: p1 (urgent) through p4 (normal) Project: #ProjectName Section: /SectionName Labels: @label1 @label2 Tasks List Tasks Filters: --project <name> - Filter by project name or id:xxx --label <name> - Filter by label (comma-separated for multiple) --priority <p1-p4> - Filter by priority --due <date> - Filter by due date (today, overdue, or YYYY-MM-DD) --filter <query> - Raw Todoist filter query --assignee <ref> - Filter by assignee (me or id:xxx) --workspace <name> - Filter to workspace --personal - Filter to personal projects only Output: View Task Details The ref can be a task name …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills intellectronica/skills--acc94e