[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M6FGKRT290VZ0F8SAFZPYDZC":3,"skill-same:01M6FGKRT290VZ0F8SAFZPYDZC":83},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":15,"categories":16,"keywords":17,"publishedAt":38,"linkOnly":39,"markdownContent":40,"markdownBody":41,"frontMatter":42,"refName":48,"commitSha":49,"skillDirectory":50,"forksCount":51,"repositoryHtmlUrl":52,"repositoryHomepageUrl":6,"ownerHtmlUrl":53,"ownerBlogUrl":6,"ownerDescription":6,"updatedAt":54,"install":55,"resources":68},"01M6FGKRT290VZ0F8SAFZPYDZC","gtasks-cli",null,"Manage Google Tasks from the command line - view, create, update, delete tasks and task lists. Use when the user asks to interact with Google Tasks, manage to-do items, create task lists, mark tasks complete, or check their Google Tasks.","kbarbel640-del\u002Fskills","kbarbel640-del","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F255315490?v=4","01M6CJPPQGCCESXMG3K7BBGQ5J","01M6CJPPX2PB2BCZERFVM2C2B3",1,"MIT","https:\u002F\u002Fgithub.com\u002Fkbarbel640-del\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fbro3886\u002Fgtasks-cli\u002FSKILL.md",[],[18,19,20,21,22,23,24,25,26,27,28,29,30,31,32,33,34,35,36,37],"cli","gtasks cli","use","google","cli tool","complete","line","google tasks","task","do","manage","tasks","view","command","check","tool","Bash","update","delete","create","2026-11-10 10:12:30",false,"---\nname: gtasks-cli\ndescription: Manage Google Tasks from the command line - view, create, update, delete tasks and task lists. Use when the user asks to interact with Google Tasks, manage to-do items, create task lists, mark tasks complete, or check their Google Tasks.\nlicense: MIT\ncompatibility: Requires gtasks CLI tool to be installed and authenticated\nmetadata:\n  author: BRO3886\n  version: \"1.0\"\nallowed-tools: Bash(gtasks:*)\n---\n\n# Google Tasks CLI Skill\n\nThis skill enables you to manage Google Tasks directly from the command line using the `gtasks` CLI tool.\n\n## Prerequisites\n\nBefore using any commands, ensure the following requirements are met:\n\n### 1. GTasks Installation\n\nCheck if gtasks is installed on the system:\n\n```bash\n# Cross-platform check (works on macOS, Linux, Windows Git Bash)\ngtasks --version 2>\u002Fdev\u002Fnull || gtasks.exe --version 2>\u002Fdev\u002Fnull || echo \"gtasks not found\"\n\n# Or use which\u002Fwhere commands\n# macOS\u002FLinux:\nwhich gtasks\n\n# Windows (Command Prompt):\nwhere gtasks\n\n# Windows (PowerShell):\nGet-Command gtasks\n```\n\n**If gtasks is not installed:**\n\n1. Download the binary for your system from [GitHub Releases](https:\u002F\u002Fgithub.com\u002FBRO3886\u002Fgtasks\u002Freleases)\n2. Install it:\n   - **macOS\u002FLinux**: Move to `\u002Fusr\u002Flocal\u002Fbin` or add to PATH\n   - **Windows**: Add to a folder in your PATH environment variable\n3. Verify installation: `gtasks --version`\n\n**IMPORTANT for Agents:** Always check if gtasks is installed before attempting to use it. If the command is not found, inform the user and provide installation instructions.\n\n### 2. Environment Variables\n\nSet up Google OAuth2 credentials as environment variables:\n\n```bash\nexport GTASKS_CLIENT_ID=\"your-client-id.apps.googleusercontent.com\"\nexport GTASKS_CLIENT_SECRET=\"your-client-secret\"\n```\n\n**How to get credentials:**\n1. Go to [Google Cloud Console](https:\u002F\u002Fconsole.cloud.google.com\u002F)\n2. Create a new project or select an existing one\n3. Enable the Google Tasks API\n4. Create OAuth2 credentials (Application type: \"Web application\")\n5. Add authorized redirect URIs:\n   - `http:\u002F\u002Flocalhost:8080\u002Fcallback`\n   - `http:\u002F\u002Flocalhost:8081\u002Fcallback`\n   - `http:\u002F\u002Flocalhost:8082\u002Fcallback`\n   - `http:\u002F\u002Flocalhost:9090\u002Fcallback`\n   - `http:\u002F\u002Flocalhost:9091\u002Fcallback`\n\n**For persistent setup**, add these to your shell profile (`~\u002F.bashrc`, `~\u002F.zshrc`, etc.):\n\n```bash\necho 'export GTASKS_CLIENT_ID=\"your-client-id\"' >> ~\u002F.bashrc\necho 'export GTASKS_CLIENT_SECRET=\"your-client-secret\"' >> ~\u002F.bashrc\nsource ~\u002F.bashrc\n```\n\n### 2. Authentication\n\nOnce environment variables are set, authenticate with Google:\n\n```bash\ngtasks login\n```\n\nThis will open a browser for OAuth2 authentication. The token is stored in `~\u002F.gtasks\u002Ftoken.json`.\n\n## Core Concepts\n\n- **Task Lists**: Containers that hold tasks (like \"Work\", \"Personal\", \"Shopping\")\n- **Tasks**: Individual to-do items within a task list\n- **Task Properties**: Title (required), notes\u002Fdescription (optional), due date (optional), status (pending\u002Fcompleted)\n\n## Command Structure\n\nAll commands follow this pattern:\n```\ngtasks [command] [subcommand] [flags] [arguments]\n```\n\n## Authentication\n\n### Login\n```bash\ngtasks login\n```\nOpens browser for Google OAuth2 authentication. Required before using any other commands.\n\n### Logout\n```bash\ngtasks logout\n```\nRemoves stored credentials from `~\u002F.gtasks\u002Ftoken.json`.\n\n## Task List Management\n\n### View All Task Lists\n```bash\ngtasks tasklists view\n```\nDisplays all task lists with numbered indices.\n\n**Output Example:**\n```\n[1] My Tasks\n[2] Work\n[3] Personal\n```\n\n### Create a Task List\n```bash\ngtasks tasklists add -t \"Work Projects\"\ngtasks tasklists add --title \"Shopping List\"\n```\nCreates a new task list with the specified title.\n\n**Flags:**\n- `-t, --title`: Task list title (required)\n\n### Delete a Task List\n```bash\ngtasks tasklists rm\n```\nInteractive prompt to select and delete a task list.\n\n### Update Task List Title\n```bash\ngtasks tasklists update -t \"New Title\"\n```\nInteractive prompt to select a task list and update its title.\n\n**Flags:**\n- `-t, --title`: New title for the task list (required)\n\n## Task Management\n\nAll task commands can optionally specify a task list using the `-l` flag. If omitted, you'll be prompted to select one interactively.\n\n### View Tasks\n\n**Basic view:**\n```bash\ngtasks tasks view\ngtasks tasks view -l \"Work\"\n```\n\n**Include completed tasks:**\n```bash\ngtasks tasks view --include-completed\ngtasks tasks view -i\n```\n\n**Show only completed tasks:**\n```bash\ngtasks tasks view --completed\n```\n\n**Sort tasks:**\n```bash\ngtasks tasks view --sort=due        # Sort by due date\ngtasks tasks view --sort=title      # Sort by title\ngtasks tasks view --sort=position   # Sort by position (default)\n```\n\n**Output formats:**\n```bash\ngtasks tasks view --format=table    # Table format (default)\ngtasks tasks view --format=json     # JSON output\ngtasks tasks view --format=csv      # CSV output\n```\n\n**Table Output Example:**\n```\nTasks in Work:\nNo  Title              Description         Status     Due\n1   Finish report      Q4 analysis         pending    25 December 2024\n2   Team meeting       Weekly sync         pending    -\n3   Code review        PR #123            completed  20 December 2024\n```\n\n**JSON Output Example:**\n```json\n[\n  {\n    \"number\": 1,\n    \"title\": \"Finish report\",\n    \"description\": \"Q4 analysis\",\n    \"status\": \"pending\",\n    \"due\": \"2024-12-25\"\n  }\n]\n```\n\n### Create a Task\n\n**Interactive mode:**\n```bash\ngtasks tasks add\ngtasks tasks add -l \"Work\"\n```\nPrompts for title, notes, and due date.\n\n**Flag mode:**\n```bash\ngtasks tasks add -t \"Buy groceries\"\ngtasks tasks add -t \"Finish report\" -n \"Q4 analysis\" -d \"2024-12-25\"\ngtasks tasks add -t \"Call dentist\" -d \"tomorrow\"\ngtasks tasks add -t \"Team meeting\" -d \"Dec 25\"\n```\n\n**Flags:**\n- `-t, --title`: Task title (required for non-interactive mode)\n- `-n, --note`: Task notes\u002Fdescription (optional)\n- `-d, --due`: Due date (optional, flexible format)\n\n**Date Format Examples:**\nThe date parser supports many formats:\n- `2024-12-25` (ISO format)\n- `Dec 25, 2024`\n- `December 25`\n- `tomorrow`\n- `next Friday`\n- `12\u002F25\u002F2024`\n\nSee [dateparse examples](https:\u002F\u002Fgithub.com\u002Faraddon\u002Fdateparse#extended-example) for all supported formats.\n\n### Mark Task as Complete\n\n**With task number:**\n```bash\ngtasks tasks done 1\ngtasks tasks done 3 -l \"Work\"\n```\n\n**Interactive mode:**\n```bash\ngtasks tasks done\ngtasks tasks done -l \"Personal\"\n```\nPrompts to select a task from the list.\n\n### Delete a Task\n\n**With task number:**\n```bash\ngtasks tasks rm 2\ngtasks tasks rm 1 -l \"Shopping\"\n```\n\n**Interactive mode:**\n```bash\ngtasks tasks rm\ngtasks tasks rm -l \"Work\"\n```\nPrompts to select a task to delete.\n\n### View Task Details\n\n**With task number:**\n```bash\ngtasks tasks info 1\ngtasks tasks info 3 -l \"Work\"\n```\n\n**Interactive mode:**\n```bash\ngtasks tasks info\ngtasks tasks info -l \"Personal\"\n```\n\n**Output Example:**\n```\nTask: Finish report\nStatus: Needs action\nDue: 25 December 2024\nNotes: Complete Q4 analysis and submit to manager\n\nLinks:\n  - https:\u002F\u002Fdocs.google.com\u002Fdocument\u002Fd\u002F...\n\nView in Google Tasks: https:\u002F\u002Ftasks.google.com\u002F...\n```\n\n## Common Workflows\n\n### Quick Task Creation\nWhen a user says \"add a task to my work list\":\n```bash\ngtasks tasks add -l \"Work\" -t \"Task title\"\n```\n\n### Check Today's Tasks\n```bash\ngtasks tasks view --sort=due\n```\n\n### Complete Multiple Tasks\n```bash\ngtasks tasks done -l \"Work\"\n# Interactive prompt appears, select task\ngtasks tasks done -l \"Work\"\n# Repeat as needed\n```\n\n### View All Tasks Across Lists\nRun view command multiple times for each list, or first list all task lists:\n```bash\ngtasks tasklists view\ngtasks tasks view -l \"Work\"\ngtasks tasks view -l \"Personal\"\n```\n\n### Export Tasks\n```bash\ngtasks tasks view --format=json > tasks.json\ngtasks tasks view --format=csv > tasks.csv\n```\n\n## Best Practices\n\n1. **Always check authentication first**: If commands fail with authentication errors, run `gtasks login`\n\n2. **Use task list flag for automation**: When scripting or when the user specifies a list name, use `-l` flag to avoid interactive prompts\n\n3. **Leverage flexible date parsing**: The `--due` flag accepts natural language dates like \"tomorrow\", \"next week\", etc.\n\n4. **Use appropriate output format**:\n   - Table format for human-readable output\n   - JSON for parsing\u002Fintegration with other tools\n   - CSV for spreadsheet import\n\n5. **Task numbers are ephemeral**: Task numbers change when tasks are added, completed, or deleted. Always view the list first to get current numbers.\n\n6. **Handle missing lists gracefully**: If a user specifies a non-existent list name, the command will error. Always verify list names first with `gtasks tasklists view`.\n\n## Error Handling\n\nCommon errors and solutions:\n\n- **\"Failed to get service\"** or **Authentication errors**:\n  - First, ensure environment variables are set: `echo $GTASKS_CLIENT_ID`\n  - If variables are not set, export them (see Prerequisites section)\n  - Then run `gtasks login` to authenticate\n- **\"incorrect task-list name\"**: The specified list name doesn't exist. Use `gtasks tasklists view` to see available lists\n- **\"Incorrect task number\"**: The task number is invalid. Use `gtasks tasks view` to see current task numbers\n- **\"Date format incorrect\"**: The date string couldn't be parsed. Use formats like \"2024-12-25\", \"tomorrow\", or \"Dec 25\"\n\n## Examples\n\n### Example 1: Create a shopping list and add items\n```bash\ngtasks tasklists add -t \"Shopping\"\ngtasks tasks add -l \"Shopping\" -t \"Milk\"\ngtasks tasks add -l \"Shopping\" -t \"Bread\"\ngtasks tasks add -l \"Shopping\" -t \"Eggs\"\n```\n\n### Example 2: Review and complete work tasks\n```bash\ngtasks tasks view -l \"Work\" --sort=due\ngtasks tasks done 1 -l \"Work\"\n```\n\n### Example 3: Add task with deadline\n```bash\ngtasks tasks add -l \"Work\" -t \"Submit proposal\" -n \"Include budget and timeline\" -d \"next Friday\"\n```\n\n### Example 4: Export completed tasks\n```bash\ngtasks tasks view --completed --format=json -l \"Work\" > completed_work.json\n```\n\n## Tips for Agents\n\n### Before Running Any Commands\n\n1. **Check gtasks installation first**:\n   ```bash\n   # Try to run gtasks version check\n   gtasks --version 2>\u002Fdev\u002Fnull || gtasks.exe --version 2>\u002Fdev\u002Fnull\n   ```\n   If this fails, inform the user that gtasks is not installed and provide installation instructions from the Prerequisites section.\n\n2. **Verify environment variables are set**:\n   ```bash\n   # Check if variables exist (macOS\u002FLinux)\n   [ -n \"$GTASKS_CLIENT_ID\" ] && echo \"GTASKS_CLIENT_ID is set\" || echo \"GTASKS_CLIENT_ID is not set\"\n   [ -n \"$GTASKS_CLIENT_SECRET\" ] && echo \"GTASKS_CLIENT_SECRET is set\" || echo \"GTASKS_CLIENT_SECRET is not set\"\n\n   # Windows PowerShell\n   if ($env:GTASKS_CLIENT_ID) { \"GTASKS_CLIENT_ID is set\" } else { \"GTASKS_CLIENT_ID is not set\" }\n   if ($env:GTASKS_CLIENT_SECRET) { \"GTASKS_CLIENT_SECRET is set\" } else { \"GTASKS_CLIENT_SECRET is not set\" }\n   ```\n\n3. **Check authentication status**:\n   ```bash\n   gtasks tasklists view &>\u002Fdev\u002Fnull && echo \"Authenticated\" || echo \"Not authenticated - run 'gtasks login'\"\n   ```\n\n### General Tips\n\n- When the user mentions \"tasks\" without specifying a tool, ask if they want to use Google Tasks\n- If the user asks about their tasks, first run `gtasks tasklists view` to see available lists\n- Always confirm which task list to use if not specified by the user\n- When creating tasks with dates, prefer explicit date formats (YYYY-MM-DD) over relative terms for clarity\n- Remember that task numbers are 1-indexed and change after modifications\n- If a command requires interaction but you're running non-interactively, use flags to provide all required information\n","# Google Tasks CLI Skill\n\nThis skill enables you to manage Google Tasks directly from the command line using the `gtasks` CLI tool.\n\n## Prerequisites\n\nBefore using any commands, ensure the following requirements are met:\n\n### 1. GTasks Installation\n\nCheck if gtasks is installed on the system:\n\n```bash\n# Cross-platform check (works on macOS, Linux, Windows Git Bash)\ngtasks --version 2>\u002Fdev\u002Fnull || gtasks.exe --version 2>\u002Fdev\u002Fnull || echo \"gtasks not found\"\n\n# Or use which\u002Fwhere commands\n# macOS\u002FLinux:\nwhich gtasks\n\n# Windows (Command Prompt):\nwhere gtasks\n\n# Windows (PowerShell):\nGet-Command gtasks\n```\n\n**If gtasks is not installed:**\n\n1. Download the binary for your system from [GitHub Releases](https:\u002F\u002Fgithub.com\u002FBRO3886\u002Fgtasks\u002Freleases)\n2. Install it:\n   - **macOS\u002FLinux**: Move to `\u002Fusr\u002Flocal\u002Fbin` or add to PATH\n   - **Windows**: Add to a folder in your PATH environment variable\n3. Verify installation: `gtasks --version`\n\n**IMPORTANT for Agents:** Always check if gtasks is installed before attempting to use it. If the command is not found, inform the user and provide installation instructions.\n\n### 2. Environment Variables\n\nSet up Google OAuth2 credentials as environment variables:\n\n```bash\nexport GTASKS_CLIENT_ID=\"your-client-id.apps.googleusercontent.com\"\nexport GTASKS_CLIENT_SECRET=\"your-client-secret\"\n```\n\n**How to get credentials:**\n1. Go to [Google Cloud Console](https:\u002F\u002Fconsole.cloud.google.com\u002F)\n2. Create a new project or select an existing one\n3. Enable the Google Tasks API\n4. Create OAuth2 credentials (Application type: \"Web application\")\n5. Add authorized redirect URIs:\n   - `http:\u002F\u002Flocalhost:8080\u002Fcallback`\n   - `http:\u002F\u002Flocalhost:8081\u002Fcallback`\n   - `http:\u002F\u002Flocalhost:8082\u002Fcallback`\n   - `http:\u002F\u002Flocalhost:9090\u002Fcallback`\n   - `http:\u002F\u002Flocalhost:9091\u002Fcallback`\n\n**For persistent setup**, add these to your shell profile (`~\u002F.bashrc`, `~\u002F.zshrc`, etc.):\n\n```bash\necho 'export GTASKS_CLIENT_ID=\"your-client-id\"' >> ~\u002F.bashrc\necho 'export GTASKS_CLIENT_SECRET=\"your-client-secret\"' >> ~\u002F.bashrc\nsource ~\u002F.bashrc\n```\n\n### 2. Authentication\n\nOnce environment variables are set, authenticate with Google:\n\n```bash\ngtasks login\n```\n\nThis will open a browser for OAuth2 authentication. The token is stored in `~\u002F.gtasks\u002Ftoken.json`.\n\n## Core Concepts\n\n- **Task Lists**: Containers that hold tasks (like \"Work\", \"Personal\", \"Shopping\")\n- **Tasks**: Individual to-do items within a task list\n- **Task Properties**: Title (required), notes\u002Fdescription (optional), due date (optional), status (pending\u002Fcompleted)\n\n## Command Structure\n\nAll commands follow this pattern:\n```\ngtasks [command] [subcommand] [flags] [arguments]\n```\n\n## Authentication\n\n### Login\n```bash\ngtasks login\n```\nOpens browser for Google OAuth2 authentication. Required before using any other commands.\n\n### Logout\n```bash\ngtasks logout\n```\nRemoves stored credentials from `~\u002F.gtasks\u002Ftoken.json`.\n\n## Task List Management\n\n### View All Task Lists\n```bash\ngtasks tasklists view\n```\nDisplays all task lists with numbered indices.\n\n**Output Example:**\n```\n[1] My Tasks\n[2] Work\n[3] Personal\n```\n\n### Create a Task List\n```bash\ngtasks tasklists add -t \"Work Projects\"\ngtasks tasklists add --title \"Shopping List\"\n```\nCreates a new task list with the specified title.\n\n**Flags:**\n- `-t, --title`: Task list title (required)\n\n### Delete a Task List\n```bash\ngtasks tasklists rm\n```\nInteractive prompt to select and delete a task list.\n\n### Update Task List Title\n```bash\ngtasks tasklists update -t \"New Title\"\n```\nInteractive prompt to select a task list and update its title.\n\n**Flags:**\n- `-t, --title`: New title for the task list (required)\n\n## Task Management\n\nAll task commands can optionally specify a task list using the `-l` flag. If omitted, you'll be prompted to select one interactively.\n\n### View Tasks\n\n**Basic view:**\n```bash\ngtasks tasks view\ngtasks tasks view -l \"Work\"\n```\n\n**Include completed tasks:**\n```bash\ngtasks tasks view --include-completed\ngtasks tasks view -i\n```\n\n**Show only completed tasks:**\n```bash\ngtasks tasks view --completed\n```\n\n**Sort tasks:**\n```bash\ngtasks tasks view --sort=due        # Sort by due date\ngtasks tasks view --sort=title      # Sort by title\ngtasks tasks view --sort=position   # Sort by position (default)\n```\n\n**Output formats:**\n```bash\ngtasks tasks view --format=table    # Table format (default)\ngtasks tasks view --format=json     # JSON output\ngtasks tasks view --format=csv      # CSV output\n```\n\n**Table Output Example:**\n```\nTasks in Work:\nNo  Title              Description         Status     Due\n1   Finish report      Q4 analysis         pending    25 December 2024\n2   Team meeting       Weekly sync         pending    -\n3   Code review        PR #123            completed  20 December 2024\n```\n\n**JSON Output Example:**\n```json\n[\n  {\n    \"number\": 1,\n    \"title\": \"Finish report\",\n    \"description\": \"Q4 analysis\",\n    \"status\": \"pending\",\n    \"due\": \"2024-12-25\"\n  }\n]\n```\n\n### Create a Task\n\n**Interactive mode:**\n```bash\ngtasks tasks add\ngtasks tasks add -l \"Work\"\n```\nPrompts for title, notes, and due date.\n\n**Flag mode:**\n```bash\ngtasks tasks add -t \"Buy groceries\"\ngtasks tasks add -t \"Finish report\" -n \"Q4 analysis\" -d \"2024-12-25\"\ngtasks tasks add -t \"Call dentist\" -d \"tomorrow\"\ngtasks tasks add -t \"Team meeting\" -d \"Dec 25\"\n```\n\n**Flags:**\n- `-t, --title`: Task title (required for non-interactive mode)\n- `-n, --note`: Task notes\u002Fdescription (optional)\n- `-d, --due`: Due date (optional, flexible format)\n\n**Date Format Examples:**\nThe date parser supports many formats:\n- `2024-12-25` (ISO format)\n- `Dec 25, 2024`\n- `December 25`\n- `tomorrow`\n- `next Friday`\n- `12\u002F25\u002F2024`\n\nSee [dateparse examples](https:\u002F\u002Fgithub.com\u002Faraddon\u002Fdateparse#extended-example) for all supported formats.\n\n### Mark Task as Complete\n\n**With task number:**\n```bash\ngtasks tasks done 1\ngtasks tasks done 3 -l \"Work\"\n```\n\n**Interactive mode:**\n```bash\ngtasks tasks done\ngtasks tasks done -l \"Personal\"\n```\nPrompts to select a task from the list.\n\n### Delete a Task\n\n**With task number:**\n```bash\ngtasks tasks rm 2\ngtasks tasks rm 1 -l \"Shopping\"\n```\n\n**Interactive mode:**\n```bash\ngtasks tasks rm\ngtasks tasks rm -l \"Work\"\n```\nPrompts to select a task to delete.\n\n### View Task Details\n\n**With task number:**\n```bash\ngtasks tasks info 1\ngtasks tasks info 3 -l \"Work\"\n```\n\n**Interactive mode:**\n```bash\ngtasks tasks info\ngtasks tasks info -l \"Personal\"\n```\n\n**Output Example:**\n```\nTask: Finish report\nStatus: Needs action\nDue: 25 December 2024\nNotes: Complete Q4 analysis and submit to manager\n\nLinks:\n  - https:\u002F\u002Fdocs.google.com\u002Fdocument\u002Fd\u002F...\n\nView in Google Tasks: https:\u002F\u002Ftasks.google.com\u002F...\n```\n\n## Common Workflows\n\n### Quick Task Creation\nWhen a user says \"add a task to my work list\":\n```bash\ngtasks tasks add -l \"Work\" -t \"Task title\"\n```\n\n### Check Today's Tasks\n```bash\ngtasks tasks view --sort=due\n```\n\n### Complete Multiple Tasks\n```bash\ngtasks tasks done -l \"Work\"\n# Interactive prompt appears, select task\ngtasks tasks done -l \"Work\"\n# Repeat as needed\n```\n\n### View All Tasks Across Lists\nRun view command multiple times for each list, or first list all task lists:\n```bash\ngtasks tasklists view\ngtasks tasks view -l \"Work\"\ngtasks tasks view -l \"Personal\"\n```\n\n### Export Tasks\n```bash\ngtasks tasks view --format=json > tasks.json\ngtasks tasks view --format=csv > tasks.csv\n```\n\n## Best Practices\n\n1. **Always check authentication first**: If commands fail with authentication errors, run `gtasks login`\n\n2. **Use task list flag for automation**: When scripting or when the user specifies a list name, use `-l` flag to avoid interactive prompts\n\n3. **Leverage flexible date parsing**: The `--due` flag accepts natural language dates like \"tomorrow\", \"next week\", etc.\n\n4. **Use appropriate output format**:\n   - Table format for human-readable output\n   - JSON for parsing\u002Fintegration with other tools\n   - CSV for spreadsheet import\n\n5. **Task numbers are ephemeral**: Task numbers change when tasks are added, completed, or deleted. Always view the list first to get current numbers.\n\n6. **Handle missing lists gracefully**: If a user specifies a non-existent list name, the command will error. Always verify list names first with `gtasks tasklists view`.\n\n## Error Handling\n\nCommon errors and solutions:\n\n- **\"Failed to get service\"** or **Authentication errors**:\n  - First, ensure environment variables are set: `echo $GTASKS_CLIENT_ID`\n  - If variables are not set, export them (see Prerequisites section)\n  - Then run `gtasks login` to authenticate\n- **\"incorrect task-list name\"**: The specified list name doesn't exist. Use `gtasks tasklists view` to see available lists\n- **\"Incorrect task number\"**: The task number is invalid. Use `gtasks tasks view` to see current task numbers\n- **\"Date format incorrect\"**: The date string couldn't be parsed. Use formats like \"2024-12-25\", \"tomorrow\", or \"Dec 25\"\n\n## Examples\n\n### Example 1: Create a shopping list and add items\n```bash\ngtasks tasklists add -t \"Shopping\"\ngtasks tasks add -l \"Shopping\" -t \"Milk\"\ngtasks tasks add -l \"Shopping\" -t \"Bread\"\ngtasks tasks add -l \"Shopping\" -t \"Eggs\"\n```\n\n### Example 2: Review and complete work tasks\n```bash\ngtasks tasks view -l \"Work\" --sort=due\ngtasks tasks done 1 -l \"Work\"\n```\n\n### Example 3: Add task with deadline\n```bash\ngtasks tasks add -l \"Work\" -t \"Submit proposal\" -n \"Include budget and timeline\" -d \"next Friday\"\n```\n\n### Example 4: Export completed tasks\n```bash\ngtasks tasks view --completed --format=json -l \"Work\" > completed_work.json\n```\n\n## Tips for Agents\n\n### Before Running Any Commands\n\n1. **Check gtasks installation first**:\n   ```bash\n   # Try to run gtasks version check\n   gtasks --version 2>\u002Fdev\u002Fnull || gtasks.exe --version 2>\u002Fdev\u002Fnull\n   ```\n   If this fails, inform the user that gtasks is not installed and provide installation instructions from the Prerequisites section.\n\n2. **Verify environment variables are set**:\n   ```bash\n   # Check if variables exist (macOS\u002FLinux)\n   [ -n \"$GTASKS_CLIENT_ID\" ] && echo \"GTASKS_CLIENT_ID is set\" || echo \"GTASKS_CLIENT_ID is not set\"\n   [ -n \"$GTASKS_CLIENT_SECRET\" ] && echo \"GTASKS_CLIENT_SECRET is set\" || echo \"GTASKS_CLIENT_SECRET is not set\"\n\n   # Windows PowerShell\n   if ($env:GTASKS_CLIENT_ID) { \"GTASKS_CLIENT_ID is set\" } else { \"GTASKS_CLIENT_ID is not set\" }\n   if ($env:GTASKS_CLIENT_SECRET) { \"GTASKS_CLIENT_SECRET is set\" } else { \"GTASKS_CLIENT_SECRET is not set\" }\n   ```\n\n3. **Check authentication status**:\n   ```bash\n   gtasks tasklists view &>\u002Fdev\u002Fnull && echo \"Authenticated\" || echo \"Not authenticated - run 'gtasks login'\"\n   ```\n\n### General Tips\n\n- When the user mentions \"tasks\" without specifying a tool, ask if they want to use Google Tasks\n- If the user asks about their tasks, first run `gtasks tasklists view` to see available lists\n- Always confirm which task list to use if not specified by the user\n- When creating tasks with dates, prefer explicit date formats (YYYY-MM-DD) over relative terms for clarity\n- Remember that task numbers are 1-indexed and change after modifications\n- If a command requires interaction but you're running non-interactively, use flags to provide all required information\n",{"name":5,"license":14,"metadata":43,"description":7,"allowed-tools":46,"compatibility":47},{"author":44,"version":45},"BRO3886","1.0","Bash(gtasks:*)","Requires gtasks CLI tool to be installed and authenticated","main","e7e336ac628c3e3bd771aff1aaa469c93778f94a","skills\u002Fbro3886\u002Fgtasks-cli",0,"https:\u002F\u002Fgithub.com\u002Fkbarbel640-del\u002Fskills","https:\u002F\u002Fgithub.com\u002Fkbarbel640-del","2026-08-23 22:39:37",{"source":8,"skillName":5,"commands":56,"prompt":66,"zipAvailable":67},[57,60,63],{"tool":58,"command":59},"npx","npx skills add kbarbel640-del\u002Fskills --skill gtasks-cli",{"tool":61,"command":62},"bunx","bunx skills add kbarbel640-del\u002Fskills --skill gtasks-cli",{"tool":64,"command":65},"pnpm","pnpm dlx skills add kbarbel640-del\u002Fskills --skill gtasks-cli","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fkbarbel640-del\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fbro3886\u002Fgtasks-cli\u002FSKILL.md",true,[69,75,79],{"path":70,"resourceType":71,"resourceTypeDesc":72,"sizeBytes":73,"sourceHtmlUrl":74},"_meta.json","REFERENCE","参考文档",273,"https:\u002F\u002Fgithub.com\u002Fkbarbel640-del\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fbro3886\u002Fgtasks-cli\u002F_meta.json",{"path":76,"resourceType":71,"resourceTypeDesc":72,"sizeBytes":77,"sourceHtmlUrl":78},"references\u002FADVANCED.md",6621,"https:\u002F\u002Fgithub.com\u002Fkbarbel640-del\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fbro3886\u002Fgtasks-cli\u002Freferences\u002FADVANCED.md",{"path":80,"resourceType":71,"resourceTypeDesc":72,"sizeBytes":81,"sourceHtmlUrl":82},"references\u002FQUICK-REFERENCE.md",6751,"https:\u002F\u002Fgithub.com\u002Fkbarbel640-del\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fbro3886\u002Fgtasks-cli\u002Freferences\u002FQUICK-REFERENCE.md",[84,114,141,162,168,188],{"skillNo":85,"name":86,"nameZh":6,"description":87,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":88,"categories":89,"keywords":95,"publishedAt":38},"01M6G8J55967D6281ACMKAKTEQ","crowd-prompting","A marketplace where AI agents improve prompts, system instructions, tool descriptions, and other text-based content with domain expertise from real-world operations — and earn tokens for valuable contributions.","https:\u002F\u002Fgithub.com\u002Fkbarbel640-del\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fzzadrian\u002Fcrowd-prompting\u002FSKILL.md",[90],{"categoryNo":91,"categoryName":92,"taxonomyType":93,"taxonomyTypeDesc":94},"01JBSEEDCAT000000000000036","内容创作者","PROFESSION","适用职业",[96,97,98,99,100,101,102,103,104,105,106,33,107,108,109,110,111,112,113],"crowd prompting","prompting","api","with","tokens","domain","world","prompts","operations","instructions","text","system","improve","productivity","marketplace","https","content","ai agents",{"skillNo":115,"name":116,"nameZh":6,"description":117,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":118,"categories":119,"keywords":125,"publishedAt":38},"01M6G8J0PKPAYVET6BWE8W4C26","dilemm-ai","Compete in DilemmAI, the prisoner's dilemma AI arena at dilemm.ai. Use when an OpenClaw agent wants to create an account, design and submit strategy prompts for their bot, enter matchmaking, analyze historical matches and leaderboards, and iterate on bot strategy. Requires headless browser automation (no API available yet).","https:\u002F\u002Fgithub.com\u002Fkbarbel640-del\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fzyori\u002Fdilemm-ai\u002FSKILL.md",[120],{"categoryNo":121,"categoryName":122,"taxonomyType":123,"taxonomyTypeDesc":124},"01JBSEEDCAT000000000000023","Skill与智能体开发","SCENARIO","使用场景",[126,98,127,128,129,130,37,131,132,133,134,135,136,137,138,139,140,103,20],"dilemm ai","arena","analyze","browser","openclaw agent","automation","browser automation","bot","openclaw","design","strategy","headless","compete","submit","matchmaking",{"skillNo":142,"name":143,"nameZh":6,"description":144,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":145,"categories":146,"keywords":150,"publishedAt":38},"01M6G8HWAF3K9SW7NP3Z83CPJ6","arxiv-paper-reviews","Interact with arXiv Crawler API to fetch papers, read reviews, and submit comments. Use when working with arXiv papers, fetching paper lists by date\u002Fcategory\u002Finterest, viewing paper details with comments, or submitting paper reviews via API at http:\u002F\u002F150.158.152.82:8000.","https:\u002F\u002Fgithub.com\u002Fkbarbel640-del\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fzxrys\u002Fweak-accept\u002FSKILL.md",[147],{"categoryNo":148,"categoryName":149,"taxonomyType":123,"taxonomyTypeDesc":124},"01JBSEEDCAT000000000000021","资料检索与研究",[151,152,153,154,155,156,157,99,158,139,20,159,98,160,161],"arxiv paper reviews","reviews","arxiv","paper","crawler","papers","comments","fetch","read","http","via",{"skillNo":163,"name":143,"nameZh":6,"description":144,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":164,"categories":165,"keywords":167,"publishedAt":38},"01M6G8HQJ7N7WMY6YV7D7SSJ16","https:\u002F\u002Fgithub.com\u002Fkbarbel640-del\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fzxrys\u002Farxiv-paper-reviews\u002FSKILL.md",[166],{"categoryNo":148,"categoryName":149,"taxonomyType":123,"taxonomyTypeDesc":124},[154,153,152,151,161,156,157,99,155,139,20,158,159,98,160],{"skillNo":169,"name":170,"nameZh":6,"description":171,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":172,"categories":173,"keywords":174,"publishedAt":38},"01M6G8HM95Y64JNVFC2HN4E2BG","git-summary","Get a quick summary of the current Git repository including status, recent commits, branches, and contributors.","https:\u002F\u002Fgithub.com\u002Fkbarbel640-del\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fzweack\u002Fgit-summary\u002FSKILL.md",[],[175,176,177,178,179,180,181,182,183,184,185,186,187],"git","summary","git summary","commits","repository","win32","status","linux","contributors","true","quick","get","branches",{"skillNo":189,"name":190,"nameZh":6,"description":191,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":192,"categories":193,"keywords":198,"publishedAt":38},"01M6G8HGEGF05CNEJCGVYFSC4R","agent-constitution","Interact with AgentConstitution governance contracts on Base Sepolia. Check compliance, read rules, log actions, query governance state.","https:\u002F\u002Fgithub.com\u002Fkbarbel640-del\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fztsalexey\u002Fagent-constitution\u002FSKILL.md",[194,195],{"categoryNo":121,"categoryName":122,"taxonomyType":123,"taxonomyTypeDesc":124},{"categoryNo":196,"categoryName":197,"taxonomyType":93,"taxonomyTypeDesc":94},"01JBSEEDCAT000000000000037","律师与法务",[199,200,201,202,99,203,204,48,205,159,32,206,207,208,209,111,210,211,212],"agent constitution","constitution","contracts","tree","query","base","log","Rules","projects","compliance","actions","state","governance","github"]