{"skill":{"slug":"agent-todo","displayName":"Agent Todo","summary":"Turn follow-up promises into an execution queue for agents. Use when chats or discussions create tasks that should be claimed and executed during heartbeat,...","description":"---\nname: agent-todo\ndescription: Local-first execution queue for OpenClaw agents. Use when an agent should turn promises into executable tasks, pick work during heartbeat, maintain its own queue inside its own workspace, or dispatch work to another registered agent workspace. Triggers: task queue, heartbeat execution, follow-up work, background tasks, multi-agent task routing.\n---\n\n# agent-todo Skill\n\nUse this skill as an execution queue, not as a passive reminder list.\n\n核心原则：每个 agent 只维护并消费自己 workspace 下的任务队列；需要跨 agent 分发时，再按 OpenClaw 已注册的 workspace 进行发现和投递。\n\n## Core commands\n\n```bash\nbash ./script.sh add \"Publish release\" \\\n  --task-type publish \\\n  --source \"forum:#19/reply:88\" \\\n  --next-action \"Push main to GitHub and publish ClawHub version\" \\\n  --success-criteria \"GitHub and ClawHub are both updated\"\n\nbash ./script.sh dispatch \"Review release\" \\\n  --to-agent reviewer \\\n  --task-type review \\\n  --source \"chat:direct\" \\\n  --next-action \"Review release artifacts\" \\\n  --success-criteria \"Feedback delivered\"\n\nbash ./script.sh run-pending --claim\nbash ./script.sh done <id> --note \"what was completed\"\nbash ./script.sh report <id>\nbash ./script.sh block <id> --reason \"why blocked\"\nbash ./script.sh setup-heartbeat --write\nbash ./script.sh setup-heartbeat --all --write\n```\n\n## Workflow\n\n1. Add tasks with enough execution context:\n   - `task_type`\n   - `next_action`\n   - `success_criteria`\n   - `source`\n2. For composite goals, prefer `plan` to split them into concrete steps.\n3. During heartbeat, run:\n   - `bash ./script.sh run-pending --claim`\n4. If it returns `EXECUTE_NOW`, do the task immediately.\n5. Prefer continuing a `running` task before opening a fresh `pending` one.\n6. To assign work to another agent, use `dispatch --to-agent <agent_id>`.\n7. After execution:\n   - success → `done`\n   - generate reply text → `report`\n   - cannot continue → `block`\n   - no longer needed → `cancel`\n\n## Storage model\n\n- Current workspace queue: `.agent-todo/tasks.json`\n- Optional local identity: `.agent-todo/local.json`\n- Workspace discovery source: `~/.openclaw/openclaw.json`\n- Heartbeat wiring: managed block in `HEARTBEAT.md`\n\nDo not hand-write workspace paths in normal usage. Let the script resolve the current workspace and discover registered workspaces from OpenClaw.\n\n## Notes\n\n- Single-workspace mode works out of the box after install.\n- Multi-agent routing is opt-in: it only matters when you call `dispatch`.\n- `setup-heartbeat --all --write` appends or updates a managed block for every discovered workspace instead of overwriting the full file.\n- `report` generates different output shapes for forum sources and direct chat sources.\n","tags":{"latest":"1.2.1"},"stats":{"comments":0,"downloads":475,"installsAllTime":18,"installsCurrent":1,"stars":1,"versions":8},"createdAt":1774142546363,"updatedAt":1778492099892},"latestVersion":{"version":"1.2.1","createdAt":1774302979574,"changelog":"Fix heartbeat workspace binding for shared/external installs; add smoke coverage.","license":"MIT-0"},"metadata":null,"owner":{"handle":"zoujiejun","userId":"s175qfvfc9b31keaykww34vsh983ftcc","displayName":"zoujiejun","image":"https://avatars.githubusercontent.com/u/37881808?v=4"},"moderation":{"isSuspicious":false,"isMalwareBlocked":false,"verdict":"clean","reasonCodes":["review.llm_review"],"summary":"Review: review.llm_review","engineVersion":"v2.4.24","updatedAt":1780090051442}}