# Task

> \<task\_skill\_guides>

- Skill: `lobehub/task` (Agent Skill, multi-file: 4 files)
- Install (CLI): `npx skillmds@latest add lobehub/task`
- Raw SKILL.md: https://api.skillmd.com/api/skills/lobehub/task/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Productivity
- Author: lobehub (https://skillmd.com/u/lobehub)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/lobehub/task

---

\<task\_skill\_guides>
You are executing a task within the LobeHub task system. Use the `lh task` CLI via `runCommand` to manage your task and related resources.

# Task Lifecycle

| Command                         | Description                                           |
| ------------------------------- | ----------------------------------------------------- |
| `lh task view <id>`             | View task details, instruction, workspace, activities |
| `lh task edit <id>`             | Update task name, instruction, status, priority       |
| `lh task complete <id>`         | Mark task as completed                                |
| `lh task comment <id> -m "..."` | Add a progress comment                                |
| `lh task tree <id>`             | View subtask tree with dependencies                   |

# Working with Subtasks

| Command                                   | Description       |
| ----------------------------------------- | ----------------- |
| `lh task create -i "..." --parent <id>`   | Create a subtask  |
| `lh task list --parent <id>`              | List subtasks     |
| `lh task sort <parentId> <id1> <id2> ...` | Reorder subtasks  |
| `lh task dep add <id> <dependsOnId>`      | Add dependency    |
| `lh task dep rm <id> <dependsOnId>`       | Remove dependency |

# Task Workspace (Documents)

| Command                                           | Description               |
| ------------------------------------------------- | ------------------------- |
| `lh task doc create <id> -t "title" -b "content"` | Create and pin a document |
| `lh task doc pin <id> <docId>`                    | Pin existing document     |
| `lh task doc unpin <id> <docId>`                  | Unpin document            |

# Task Topics (Conversations)

| Command                             | Description              |
| ----------------------------------- | ------------------------ |
| `lh task topic list <id>`           | List conversation topics |
| `lh task topic view <id> <topicId>` | View topic messages      |

# Usage Pattern

1. Read the reference file for detailed command options: `readReference('references/commands')`
2. Run commands via `runCommand` — the `lh` prefix is automatically handled
3. Use `--json` flag on any command for structured output
4. Use `lh task <subcommand> --help` for full command-line help

# Task Execution Guidelines

- **Check your task first**: Use `lh task view` to understand the full instruction and context
- **Use workspace documents**: Store outputs and deliverables as task documents
- **Report progress**: Use `lh task comment` to log key milestones
- **Respect dependencies**: Check `lh task tree` to understand task ordering
- **Complete when done**: Use `lh task complete` when all deliverables are ready
- **Automation tasks are the exception — NEVER complete them**: a task with automation (heartbeat or schedule — shown as an `Automation:` line in the task context) is a recurring loop, and this run is one tick of it. NEVER run `lh task complete` (or set a terminal status via `lh task edit --status`) on that task: a terminal status cancels the in-flight run and permanently disarms the loop — no future tick will fire and nothing recovers it. A tick with nothing to do is still a successful run; just finish your turn and the next tick is armed automatically. Only the user retires a recurring task.
  \</task\_skill\_guides>