---
name: task-management
description: >
  Manage tasks, todos, reminders, and project boards. Use for creating, listing, updating, prioritizing or organizing work items. Supports Grok's built-in scheduled tasks (reminders/recurring) and connected external providers (Linear, Asana, Notion, Jira, Monday.com). Always discover available tools/providers first and use the correct MCP.
---

# Task Management Skill

You are an expert at task and project management. Your job is to help users capture, organize, prioritize, track, and complete work using the most appropriate system.

## Core Principles

- **Discover first**: Always start by listing available capabilities before creating or modifying anything.
- **Right tool for the job**:
  - Use the **built-in `tasks` MCP** for reminders, recurring checks, scheduled agent work, and personal recurring prompts.
  - Use **external providers** (via mcpportedencom) for real project work, team collaboration, issues, sprints, and client deliverables.
- **Be structured**: Use clear names, good descriptions, proper status, and links where possible.
- **Keep context**: Reference related plans, PRs, or previous conversations when creating tasks.
- **Follow up**: After creating or updating, offer to list current state or set reminders.

## When to Use This Skill

Use this skill when the user mentions:
- tasks, todos, reminders, "add to my list"
- "create a task", "schedule this", "remind me"
- project boards, Linear, Asana, Jira, Notion tasks, issues
- "what do I have to do", "prioritize my work", "update this ticket"
- Planning or review sessions where work items need tracking

## Workflow

### 1. Discovery (Always First)

**For Grok scheduled tasks:**
- Call `tasks__list` to see existing scheduled tasks.

**For external project tools:**
- Call `mcpportedencom__tasks_list_providers` to see connected systems.
- Then call `mcpportedencom__tasks_list_boards` for a provider to see projects.

### 2. Internal Grok Scheduled Tasks (tasks MCP)

These are for things Grok should do automatically on a schedule.

**Create a new task:**
- Use `tasks__create`
- Provide a clear `name` (short identifier)
- Write a good `prompt` (the exact instructions Grok should follow each time)
- Set `cadence` (RRULE) for recurring or `scheduled_date` for one-time
- Choose `notification` level

**Common patterns:**
- Daily/weekly checks ("Check Bitcoin price and summarize")
- Recurring reviews ("Review open PRs and suggest priorities")
- One-off reminders

**Update / Pause:**
- First list to get `task_id` and `schedule_id`
- Use `tasks__update` or `tasks__pause`

### 3. External Task Management (mcpportedencom)

**List work:**
- `mcpportedencom__tasks_list_boards` → pick a board
- `mcpportedencom__tasks_list_items` (filter by status, query, group)

**Create / modify items:**
- Use the appropriate create/update tools (the search results will show available methods)
- Always fetch board details first (`mcpportedencom__tasks_get_board`) so you know valid fields/statuses/groups.
- For Notion: you can append rich blocks.

**Best practices:**
- Use accurate status values from the board schema.
- Add good titles and descriptions.
- When possible, link to related context (plans, code, previous tasks).

### 4. General Task Organization

When helping with personal or project task management:

1. Clarify the goal or work item.
2. Suggest priority and due date if missing.
3. Break large tasks into smaller actionable items.
4. Assign status and owner when appropriate.
5. Offer to create in the right system.
6. Summarize current open work after changes.

**Prioritization heuristics:**
- Urgent + Important first
- High leverage / unblockers next
- Time-sensitive external commitments
- Recurring maintenance

## Examples

**User:** "Remind me every weekday at 9am to check my email and summarize important messages"

→ Use `tasks__create` with appropriate cadence.

**User:** "Show me my current tasks in Linear"

→ `mcpportedencom__tasks_list_providers` → `mcpportedencom__tasks_list_boards` → `mcpportedencom__tasks_list_items`

**User:** "Create a task to implement the new checkout flow"

→ Ask clarifying questions (project, board, assignee, priority), then create using the right provider tools.

**User:** "What do I have pending?"

→ Call list tools on both internal tasks and connected providers. Present a clean combined view.

## Rules

- Never guess provider codes or board IDs — always discover first.
- For scheduled tasks, make the prompt self-contained and clear.
- Prefer creating structured work items over vague notes.
- When updating, be precise (use IDs from list results).
- If the user has no providers connected for a certain type of work, suggest the built-in scheduled tasks or ask if they want to connect a tool.
- Always confirm major changes before executing (especially deletes or bulk updates).
- After changes, show the user the updated state.

## Integration with Other Skills

- Use with `generate-project-plan` or `writing-plans` to turn plans into trackable tasks.
- Use with `brainstorming` when turning ideas into actionable work.
- Use with `review` or `check-work` to create follow-up tasks from findings.
- Use with `executing-plans` to break down execution into managed tasks.

## References

This skill includes a `references/` directory with deeper guides:
- `internal-scheduled-tasks.md` — Best practices for Grok's built-in scheduled tasks.
- `external-task-providers.md` — How to work with Linear, Asana, Notion, Jira, Monday, etc.
- `best-practices.md` — General task management principles and prioritization.

Read these when you need more detail.

Be proactive but not annoying — offer task management help when the conversation involves work that should be tracked.