opencode-skills/commands/task.md

/task

Create, update, complete, or list tasks. Single command for all task CRUD operations.

Subcommands

/task add [details]

/task (no args -- defaults to add)

Create a new task.

Shortcut mode: /task add "Title" high due:2026-04-15 initiative:Messaging-System effort:medium

Guided mode (no args or incomplete): Ask these questions one at a time:

1. Task title -- short, action-oriented
2. Initiative -- which initiative does this belong to? (list active initiatives from AGENTS.md, or "Personal", or "None")
3. Priority -- High / Medium / Low
4. Due date -- YYYY-MM-DD or TBD
5. Effort -- Quick (<30 min) / Medium (30 min - 2h) / Deep (2h+)
6. Context -- paths to context files in ~/LLM Context/ (or "none")
7. Description -- what needs to be done

After gathering info:

• Create file at todo/YYYY-MM-DD-short-slug.md using today's date
• Use the template from meta/templates/task-template.md
• Remove the Completed field (not applicable in todo/)
• Confirm creation with: "Created: todo/YYYY-MM-DD-slug.md"

/task update [search-term]

Modify an existing task.

1. Search across todo/, ongoing/, and blocked/ for a task matching the search term (title match, fuzzy is fine)
2. If multiple matches, show them and ask which one
3. Show the current task state
4. Ask what to update -- offer these options:
   • Priority
   • Due date
   • Effort
   • Description
   • Notes (append)
   • Move to a different status folder
   • Multiple fields at once
5. Apply the update and confirm

If status changes: move the file to the new folder. If moving to done/, add Completed date (use /task done flow).

/task done [search-term]

Mark a task as completed.

1. Search across todo/, ongoing/, and blocked/ for the task
2. Show the current task and ask for confirmation
3. Ask: "Any notes to add before closing?"
4. Add Completed date (today) to the task file
5. Move file to done/
6. Confirm: "Completed: moved to done/YYYY-MM-DD-slug.md"

/task list

Quick flat listing of all open tasks. Lightweight -- no inference, no analysis.

1. Read all files in todo/, ongoing/, and blocked/
2. Output a simple table:

| Task | Initiative | Priority | Due | Folder |
|------|-----------|----------|-----|--------|
| ... | ... | ... | ... | todo/ongoing/blocked |

Sorted by priority then due date (same rules as /agenda).

Rules

• All task files live in ~/Workspace/Personal/Tasks/
• Use meta/templates/task-template.md as the canonical format
• Filename convention: YYYY-MM-DD-short-slug.md
• When creating: date = today. When moving: keep the original filename (created date doesn't change)
• The Completed field only appears in files inside done/
• When cancelling: move to cancelled/, add reason in Notes