workspace-show-status

name	workspace-show-status
description	Show TODO progress and background agent status for a workspace. Use to check how far along an existing workspace is before deciding next steps.
context	fork

workspace-show-status

Overview

This skill displays the current workspace status including TODO progress and background agent status.

Paths: Use relative paths from project root (see CLAUDE.md for details).

Steps

1. Workspace

Required: User must specify the workspace.

• If workspace is not specified, abort with message:

  Please specify a workspace. Example: /workspace-show-status workspace/feature-user-auth-20260116

• Workspace format: workspace/{workspace-name} or just {workspace-name}

2. Check TODO Progress

Run the status check script:

.claude/skills/workspace-show-status/scripts/check-status.sh {workspace-name}

3. Check Background Agents

Use the /tasks command or check running background tasks to see agent status.

4. Output Format

Display in the following format:

## Current Workspace
workspace/{workspace-name}/

## TODO Progress
### TODO-{repo-name}.md
- Completed: X
- Incomplete: Y
- In Progress: Z
- Blocked: B
- Progress: XX%

Blocked items:
- [!] Item that is blocked (reason)

In-progress items:
- [~] Item currently being worked on

Incomplete items:
- [ ] Item 1
- [ ] Item 2

## Background Agents
- workspace-repo-todo-executor: running / completed / not started
- workspace-repo-review-changes: running / completed / not started

Notes

• Display only the status information
• Keep the output concise and structured
• Show incomplete TODO items (up to 5) if any exist
• [!] marks blocked items — items the executor could not complete due to unresolved issues
• [~] marks in-progress items — items currently being worked on by a background agent