| name | ops-status-report |
| description | Generate a recurring status snapshot of a folder-based workspace (clients, pipeline files, recent activity, command health checks) ending in an Attention Needed section that surfaces what is stalled or overdue. Read-only except for the report file. Use when the user says "status report", "weekly report", "what's going on in this workspace", or "ops snapshot". |
Ops Status Report
A workspace full of markdown and folders holds an honest status report nobody compiles. This skill compiles it: what is active, what is overdue, what went quiet. The Attention Needed section is the whole point; everything else is supporting evidence.
Step 0: Load the report config (once)
Look for an ops-report.config.md file in the project root. If it does not exist, interview the user about what "status" means in their workspace, then offer to save it. The config defines a list of sections, each one of these shapes:
FOLDER_SCAN A folder where each subfolder or file is a tracked item,
plus which line or frontmatter key holds its status
FRONTMATTER_TALLY A folder of markdown files, which keys to tally
(e.g. status), and which date key flags overdue items
RECENT_ACTIVITY A folder to check for files created or modified in the
last N days
COMMAND A read-only command whose output summarizes a tool
(e.g. a CLI status command), and what failure means
REPORTS_FOLDER Where finished reports are saved
Step 1: Collect (read-only)
Run every configured section. Rules of collection:
- Missing files or folders are findings ("item X has no status file"), not errors to silently skip.
- Dates that cannot be parsed are listed as-is, never guessed.
- A COMMAND that fails gets one line with the reason ("not run: missing .env"), and the report continues.
Step 2: Write the report
Save to REPORTS_FOLDER/ops-report-<YYYY-MM-DD>.md:
# Ops Report: <date>
## <One section per config entry>
Tables for tallies, lists for activity, short summaries for commands.
## Attention needed
Three to five bullets maximum, ordered by cost of ignoring them:
overdue items first, then untracked items, then things that went quiet.
If everything is genuinely fine, Attention Needed is one line saying so. Invented urgency kills trust in the report faster than a missed item.
Step 3: Deliver
Show the Attention Needed section in chat with the report path. If the user wants this on a schedule, suggest their scheduler of choice run the skill weekly.
Rules
- Read-only except the report file itself. The report never fixes what it finds; it names it.
- Numbers come from counting, not estimating. If something could not be counted, the report says so.
- No em dashes in any output.
Output
A dated ops report file plus the Attention Needed highlights in chat.
