Proactively notify the orchestrator when a task is done, blocked, or failed.
Proactively notify the orchestrator when a task is done, blocked, or failed. Use this skill to keep the orchestrator informed without waiting for a scheduled check-in.
When status is done and a taskPath is provided, the task file is automatically moved from in_progress/ to done/ in the project's .crewly/tasks/ directory.
| Flag | JSON Field | Required | Description |
|---|---|---|---|
--session / -s | sessionName | Yes | Your agent session name |
--status / -S | status | Yes | Status: done, blocked, failed, in_progress, active |
--summary / -m | summary |
| Yes |
| Brief description (or pipe via stdin) |
--summary-file | — | No | Read summary from a file path |
--project / -p | projectPath | No | Project path for auto-remember on completion |
--task-path | taskPath | No | Task file path; auto-moves to done/ on completion |
--task-id | taskId | No | Task ID (for structured StatusReport format) |
--progress | progress | No | Progress percentage 0-100 |
--structured | structured | No | Use structured StatusReport format |
# Report done
bash execute.sh --session dev-1 --status done --summary "Finished auth module, all tests pass" --project /path/to/project
# Report a blocker
bash execute.sh --session dev-1 --status blocked --summary "Waiting on API credentials from ops team"
# Report failure
bash execute.sh --session dev-1 --status failed --summary "Build fails due to missing dependency"
# Multi-line summary via stdin (avoids shell escaping)
echo "Fixed the bug — it's working now" | bash execute.sh --session dev-1 --status done --project /path
# Summary from file
bash execute.sh --session dev-1 --status done --summary-file /tmp/summary.txt --project /path
bash execute.sh '{"sessionName":"dev-1","status":"done","summary":"Finished implementing auth module","taskPath":"/path/.crewly/tasks/delegated/in_progress/implement_auth_1234.md"}'
JSON confirmation that the status notification was sent to the orchestrator. If taskPath was provided with done status, also returns the task completion result.