home / skills / 0juano / agent-skills / ticktick

ticktick skill

safe

This skill helps you manage TickTick tasks and projects, add, update, complete, and review tasks, and set due dates or reminders.

npx playbooks add skill 0juano/agent-skills --skill ticktick

Review the files below or copy the command above to add this skill to your agents.

Files (3)

SKILL.md

2.6 KB

---
name: ticktick
description: >
  Manage TickTick tasks and projects for JMO. Use when the user asks to add,
  create, or capture a task or todo; list, show, or review pending tasks;
  complete or check off a task; update a task's priority, due date, notes, or
  tags; delete a task or list; create or manage a project/list; or see what's
  due today or overdue. Also handles quick captures like "remind me to..." or
  "don't let me forget...".
metadata:
  author: 0juano
  version: "1.1.0"
---

# TickTick

Manage tasks and projects via `scripts/tt.sh`. Full API reference in `references/api.md`.

**Auth:** `TICKTICK_TOKEN` env var (set in shell from Infisical).
**Timezone:** All dates in ART (America/Buenos_Aires, UTC-3). Script appends `-03:00` automatically.
**Inbox ID:** `inbox131039472`

## Quick Reference

```bash
# Load token (if not already in env)
export TICKTICK_TOKEN=$(infisical secrets get TICKTICK_TOKEN \
  --token="$INFISICAL_TOKEN" --projectId="$INFISICAL_PROJECT_ID" \
  --env=prod --plain 2>/dev/null | tail -1)

TT="bash /root/.openclaw/workspace/skills/ticktick/scripts/tt.sh"
```

## Commands

### List projects
```bash
$TT projects
```

### List tasks
```bash
$TT tasks                          # inbox (default)
$TT tasks --project "Work"         # by name
$TT tasks --project <projectId>    # by ID
```

### Add a task
```bash
$TT add "Buy tennis grip"
$TT add "Call accountant" --priority high --due "2026-02-20T10:00:00"
$TT add "Draft email" --project "Work" --priority med --notes "Reply to Yarilin"
$TT add "Review PR" --tag "work,code"
```
Priority values: `none` | `low` | `med` | `high`

### Complete a task
```bash
$TT complete <taskId> --project <projectId>
# Inbox tasks: --project flag optional (defaults to inbox)
```

### Update a task
```bash
$TT update <taskId> --project <projectId> --priority high
$TT update <taskId> --title "New title" --due "2026-02-25T09:00:00"
```

### Delete a task
```bash
$TT delete <taskId> --project <projectId>
```

### Manage projects
```bash
$TT add-project "Tennis"           # creates new list
$TT add-project "Work" --color "#FF5733"
$TT delete-project <projectId>
```

## Workflow

1. **Quick capture** — if no project specified, task lands in Inbox
2. **Find taskId** — run `$TT tasks` or `$TT tasks --project X`, copy the id from output
3. **Find projectId** — run `$TT projects`, copy the id

## Display Format

When showing tasks to JMO, format like this:
```
📋 Inbox — 3 pending

  ○ [HIGH]  Call accountant            — due Feb 20
  ○ [MED]   Review BT analytics
  ○         Buy tennis racket grip
```
Sort by: priority (high first), then due date. Hide completed tasks unless asked.

Overview

This skill manages TickTick tasks and projects for JMO, letting you capture, list, update, complete, and delete tasks quickly. It supports quick captures (inbox), project management, priority and due-date changes, notes and tags, and formatted task listings suitable for JMO's review. Timezone behavior and default inbox handling are applied automatically.

How this skill works

The skill runs TickTick commands under the hood to create, update, list, complete, and delete tasks and projects. If no project is specified, new tasks go to the Inbox. Dates are handled in the configured timezone and the skill formats task lists with priority-first sorting and clear, compact output suitable for review. It hides completed tasks by default unless explicitly requested.

When to use it

Add or capture a quick task like “remind me to …” or “don’t let me forget …”.
List pending tasks in the Inbox or a specific project for review.
Update a task’s title, due date, priority, notes, or tags.
Mark a task complete or undo completion.
Create or delete a project/list.
See what’s due today or overdue.

Best practices

When capturing quickly, omit the project to let the task land in Inbox for triage.
Include explicit ISO-like due timestamps (YYYY-MM-DDThh:mm:ss) to avoid ambiguity.
Use priority values none|low|med|high to ensure consistent sorting.
Run project and task listing commands to copy IDs before updating or deleting.
Ask for a formatted list when reviewing tasks to get sorted, human-friendly output.

Example use cases

User: “Remind me to call the accountant tomorrow at 10.” -> skill: add task with due date and high/med priority if requested.
User: “Show me Inbox tasks” -> skill: list pending Inbox tasks formatted and sorted by priority and due date.
User: “Mark task <id> as complete” -> skill: complete the specified task (Inbox project implied if not provided).
User: “Create a project called Tennis” -> skill: add a new project/list and return its ID.
User: “Update task <id> to due next Friday and set priority high” -> skill: modify due date and priority accordingly.

FAQ

What happens if I don’t specify a project when adding a task?

The task is placed in the Inbox for later triage.

How are dates interpreted?

Dates use the configured timezone; supply complete timestamps to ensure exact scheduling.