Skip to content
Skills Library
Personal productivity · Planning

task-assistant

/task-assistant

Intelligent task management via the `task` CLI. Invoke when users ask to: create/list/update/delete tasks, search tasks (text or semantic), track work items with due dates, organize tasks into projects, run batch operations, generate activity reports, or manage recurring tasks. Supports natural language dates and Google Calendar sync.

Repository
task ↗
Licence
MIT
Last repository change
02.10.2026

Assessment and security

100/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content35 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
5
Scripts
0
HTML comments
0
URLs in SKILL.md
0
Deprecation

No signals detected. Repository changed on 02.10.2026, without references to retired models or APIs.

Licence

MIT, open: use and modify while retaining author attribution.

What it does and when to use it

Intelligent task management via the `task` CLI. Invoke when users ask to: create/list/update/delete tasks, search tasks (text or semantic), track work items with due dates, organize tasks into projects, run batch operations, generate activity reports, or manage recurring tasks. Supports natural language dates and Google Calendar sync.

Original author description

Intelligent task management via the `task` CLI. Invoke when users ask to: create/list/update/delete tasks, search tasks (text or semantic), track work items with due dates, organize tasks into projects, run batch operations, generate activity reports, or manage recurring tasks. Supports natural language dates and Google Calendar sync.

How it works

  1. Overview
  2. Quick Start
  3. Core Operations
  4. Additional Resources
Original SKILL.md headings · 112 lines, 438 words
SKILL.md preview
---
name: task-assistant
description: "Intelligent task management via the `task` CLI. Invoke when users ask to: create/list/update/delete tasks, search tasks (text or semantic), track work items with due dates, organize tasks into projects, run batch operations, generate activity reports, or manage recurring tasks. Supports natural language dates and Google Calendar sync."
---

# Task Assistant

## Overview

This skill enables task management via the `task` CLI tool backed by SQLite with
vector search. Use this skill to create, track, update, and organize tasks
during coding sessions.

## Quick Start

```bash
# Create a task
task add "Implement authentication" --project Backend -d "next friday"

# Create a task with tags
task add "Fix login bug" --tag bug --tag auth

# List tasks
task list                              # Active tasks
task list -q "auth"                    # Text search
task list --tag bug                    # Filter by tag
task list --semantic "API integration" # Semantic search

# Update task
task update 1 --status done

# View details
task view 1
```

## Core Operations

### Creating Tasks

```bash
# Basic task
task add "Task title" "Optional description"

# With project and due date (supports datetime)
task add "Review PR" --project Work -d "tomorrow at 14:00"

# As subtask
task add "Write tests" --parent 5

# Output JSON for programmatic use
task add "Deploy fix" --json
```

### Listing and Searching

```bash
task list                           # Active (non-done) tasks
task list --all                     # Include completed
task list -q "search term"          # Text search
task list --semantic "bug fixes"    # AI-powered similarity search
task list --overdue                 # Past due date
task list --status in-progress      # Filter by status
task list --priority 2              # Filter by priority (0=normal, 1=high, 2=urgent)
task list --project "Backend"       # Filter by project
```

### Updating Tasks

```bash
task update <id> --status done        # Mark complete
task update <id> --status in-progress # Start working
task update <id> --priority 2         # Set urgent
task update <id> --due "2025-12-31T14:00:00Z"  # Change due date
task update <id> --title "New title"  # Change title
task update <id> -D "New description" # Change description
task update <id> --project "Work"     # Move to project
task update <id> --clear-project      # Remove from project
```

### Comments and Attachments

```bash
task comment <id> "Progress note here"
task attach <id> ./relevant-file.pdf
```

### Batch Operations

```bash
# Batch create from JSON file
task batch-add --file tasks.json

# Bulk update multiple tasks
task bulk update 1 2 3 --status done

# Bulk delete
task bulk delete 4 5 6 --yes
```

### Tag Management

```bash
task tag list                      # List all tags with usage counts
task tag add <id> bug priority     # Add tags to a task
task tag remove <id> bug           # Remove tag from task
```

## Additional Resources

- **For setup instructions** (semantic search, Google Calendar): Read
  `references/setup_guide.md`
- **For advanced features** (recurring tasks, reports, workspaces,
  multi-database): Read `references/advanced_features.md`
- **For TUI keyboard shortcuts**: Read `references/tui_reference.md`
- **For complete API reference**: Read `references/api_reference.md`
Files in this package (5)
  • SKILL.md 3 KB
  • references/advanced_features.md 4 KB
  • references/api_reference.md 18 KB
  • references/setup_guide.md 2 KB
  • references/tui_reference.md 3 KB

Versions

The database has no other skills named task-assistant.

Database snapshot: 13.11.2026 · package version 9ee53bf7a7f0 (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 100task-management
    Manage tasks, projects, and areas using the tdn CLI. Use when the user wants to create, update, query, or organize their tasks. This skill helps Claude work as a productivity assistant for life and work tasks.
  • 95gws-tasks
    Google Tasks CLI operations via gws. Use when users need to manage task lists, view/create/update/delete tasks, move tasks, or clear completed. Triggers: google tasks, task list, todo, task management.
  • 90workspace-assistant
    This skill should be used when the user asks to create quick tasks, log bugs, track one-off work items, or manage tasks in the default project. Triggers on phrases like 'add a task', 'log a bug', 'track this', 'create a quick task', 'update task status'.
  • 96things-mac
    Manage Things 3 via the `things` CLI on macOS (add/update projects+todos via URL scheme; read/search/list from the local Things database). Use when a user asks OpenClaw to add a task to Things, list inbox/today/upcoming, search tasks, or inspect projects/areas/tags.
  • 93google
    Personal assistant for Google Workspace using gog CLI. Search Gmail, manage Calendar, organize Drive, update Sheets, track Tasks, and lookup Contacts. Use when triaging email, scheduling meetings, finding availability, searching documents, managing tasks, or any Google service…
  • 96things-mac
    Manage Things 3 via the `things` CLI on macOS (add/update projects+todos via URL scheme; read/search/list from the local Things database). Use when a user asks ArgentOS to add a task to Things, list inbox/today/upcoming, search tasks, or inspect projects/areas/tags.

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.