status-report

Formats work status replies as an epic summary paragraph plus a command-backed task table.

1|Updated Jan 14, 2024
One-click install
npx skills add https://github.com/Eyhenij/rt-tools --skill status-report-eyhenij
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: status-report
Source: https://github.com/Eyhenij/rt-tools/tree/main/.claude/skills/status-report
Command: npx skills add https://github.com/Eyhenij/rt-tools --skill status-report-eyhenij

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? When a project owner asks "what is the status" or "what are you doing now", ad-hoc prose answers drift between sessions, omit tasks, and state unverified claims. This rule defines a fixed reply shape so every status answer is consistent, complete, and backed by freshly run commands. ## Core Features & Use Cases - Fixed reply structure: A short paragraph describing the epic (why it exists, how many tasks, which one runs now), followed by a table listing every epic task in plan order plus tasks created outside the epic. - Command-backed state cells: Every cell about the repository state must cite a number from a command run in the same turn — run numbers, PR numbers, scenario counts — never the bare word "done". - Guard hooks: Companion hooks (claim-guard.sh, git-guard-draft-ready.sh) refuse turn endings where tree claims lack a backing command or a draft PR is left silent. - Use Case: The owner asks "where does the work stand?" mid-epic; the agent runs npm run epic:table, checks the branch tip and latest run, and replies with the epic paragraph, the full task table, and at most two closing lines about what is awaited. ## Quick Start Ask the agent "what is the status of the current epic" and it will assemble the command-backed task table reply defined by this rule.

Frequently Asked Questions about status-report

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

FAQPage Schema
How do I answer "what is the status" for an epic in progress?

Reply with a short paragraph describing the epic's purpose and current task, then a table listing every epic task in plan order with its state. Each state cell must cite a number from a command run in the same turn, such as a run or PR number.

How to generate a task status table from an epic plan?

Run `npm run epic:table` optionally with an epic number; without one it is derived from the current branch. The tool reads the task order from the epic plan in docs/plans/ and the state of each task from the hosting.

Why must status claims be backed by a command?

Session memory is unreliable: a fresh session remembers nothing and a long one summarizes inconsistently, so two answers about the same work can disagree. The claim-guard hook refuses any turn that states tree facts without a command that showed them.

What happens if a pull request is still a draft in a status report?

A draft PR must be called a draft aloud, together with what is awaited to lift it. The git-guard-draft-ready hook refuses turn endings where work is ready but the draft state is not named.

What are the limitations of this status report rule?

Only command-backing and draft-PR naming are machine-checked; the table format, epic paragraph, task ordering, and two-line closing are held by the responder's memory. A run older than the branch tip is also not automatically detected.