report-status

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)

# 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

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.