skills.rest
Arasz
AraszCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

status-report

Generates a mid-task progress snapshot from task-tracking files, plans, and worktrees.

2|Updated Jul 18, 2026
Search Tags:#checklist#worktrees#python#status report#task tracking#subagent delegation#progress snapshot
One-click install
npx skills add https://github.com/Arasz/ai-badger --skill status-report-arasz
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: status-report
Source: https://github.com/Arasz/ai-badger/tree/main/features/common/skills/status-report
Command: npx skills add https://github.com/Arasz/ai-badger --skill status-report-arasz

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve? When work is still in flight, answering "where are we?" usually means interrupting the running task, digging through tracking files by hand, or guessing. This Skill answers status requests immediately from the tracking state the task pipeline already writes, without waiting for the task to finish or delegating the question elsewhere. ## Core Features & Use Cases - Four-section snapshot: Reports the current task, a progress checklist from plan files, the verbatim next-step note, and sub-agent/delegation status in one read. - Graceful degradation: Missing or corrupt tracking files render as placeholders like "(no task in progress)" instead of failing; the script exits 0 on every reporting path. - Live-lane detection: Surfaces worktrees with no tracker row (untracked work), marks sessions with dead pids as STALE, and distinguishes recorded subagent completions from in-flight delegations. - Use Case: Mid-implementation, a user asks "what's the current task and is the delegation done?" The agent runs one script and answers with the open task id, plan checklist counts, the queued next item, and which lanes are actually live. ## Quick Start Ask the agent "give me a status report on the current task and any running delegations" and it will run the snapshot script and summarize the four sections.

Frequently Asked Questions about status-report

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I get a task progress report without stopping the running task?▼

Run the status_report.py script from the project root; it reads the tracking files the task pipeline already writes and prints current task, checklist progress, next step, and delegation status. It never waits on running subagents and exits 0 on every reporting path.

How to check subagent delegation status from tracking files?▼

The report combines recorded subagent entries from token usage data with live evidence: lane worktrees for open tasks and the sessions table with pid liveness checks. Recorded entries only appear on completion, so live lanes are the signal for in-flight delegations.

Does the status report work if tracking files are missing or corrupt?▼

Yes. Each data source degrades independently: missing or unreadable files render as placeholders like "(no task in progress)" or "(not found)" rather than raising errors. The script is stdlib-only and returns exit code 0 on all reporting paths.

Why does the report show no recorded subagents while delegation is running?▼

Subagent records are written only when a delegation completes, so mid-flight work is invisible in that section. Check the live lanes, untracked worktrees, and sessions sections instead, which reflect work currently on disk.

What are the limitations of the plan checklist progress count?▼

The checklist counts only markdown checkbox lines (- [ ] / - [x]); plans written without checkboxes report no items rather than zero progress. If no plan filename matches the task id, the newest plan is used as a fallback and flagged for verification.

Related Skills

Explore More Software Engineering Skills→
AraszArasz
2

status-report

Generates a mid-task progress snapshot from task-tracking files, plans, and worktrees.

Community
Intermediate
SocketDevSocketDev
125

managing-worktrees

Create, prune, and land isolated Git worktrees for parallel Claude sessions.

Official
Advanced
phuetzphuetz
30

model-usage

Analyze per-model usage, costs, and token consumption from session JSON files.

Community
Intermediate
SocketDevSocketDev
56

worktree-management

Create, review, and prune Git worktrees for pull request workflows.

Official
Intermediate