| name | Report Status |
| description | Proactively notify the orchestrator when a task is done, blocked, or failed. |
| version | 1.0.0 |
| category | task-management |
| skillType | claude-skill |
| assignableRoles | ["developer","qa","tpm","designer","frontend-developer","backend-developer","fullstack-dev","qa-engineer","product-manager","architect","generalist","sales","support"] |
| triggers | ["report status","notify orchestrator","task done","task blocked","task failed"] |
| tags | ["task","status","notification","orchestrator"] |
| execution | {"type":"script","script":{"file":"execute.sh","interpreter":"bash","timeoutMs":15000}} |
Report Status
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.
Parameters
| 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 |
Examples — CLI Flags (preferred)
bash execute.sh --session dev-1 --status done --summary "Finished auth module, all tests pass" --project /path/to/project
bash execute.sh --session dev-1 --status blocked --summary "Waiting on API credentials from ops team"
bash execute.sh --session dev-1 --status failed --summary "Build fails due to missing dependency"
echo "Fixed the bug — it's working now" | bash execute.sh --session dev-1 --status done --project /path
bash execute.sh --session dev-1 --status done --summary-file /tmp/summary.txt --project /path
Examples — Legacy JSON (backward compatible)
bash execute.sh '{"sessionName":"dev-1","status":"done","summary":"Finished implementing auth module","taskPath":"/path/.crewly/tasks/delegated/in_progress/implement_auth_1234.md"}'
Output
JSON confirmation that the status notification was sent to the orchestrator. If taskPath was provided with done status, also returns the task completion result.