run-status

$npx mdskill add fabriqaai/specs.md/run-status

Displays active run status and progress details including work item, mode, duration, and file changes.

  • Helps users monitor ongoing executions and track progress during long-running tasks.
  • Reads from a state.yaml file to access the runs.active array for current run data.
  • Checks for active runs and outputs status based on predefined steps and checkpoints.
  • Presents results in a structured markdown format with sections for progress and recent activity.

SKILL.md

.github/skills/run-statusView on GitHub ↗
---
name: run-status
description: Display current run status and progress. Shows work item, mode, duration, and files changed.
version: 1.0.0
---

<objective>
Display current run status and progress.
</objective>

<triggers>
  - User asks about run status
  - During long-running execution
</triggers>

<flow>
  <step n="1" title="Check Active Run">
    <action>Read state.yaml for runs.active[] array</action>
    <check if="no active run">
      <output>
        No active run. Last completed run: {last-run-id}
      </output>
      <stop/>
    </check>
  </step>

  <step n="2" title="Display Status">
    <output>
      ## Run Status: {run-id}

      **Work Item**: {title}
      **Intent**: {intent-title}
      **Mode**: {mode}
      **Started**: {started}
      **Duration**: {elapsed}

      ### Progress

      - [x] Initialize run
      - [x] Load context
      {checkpoint status}
      - [{status}] Execute implementation
      - [ ] Run tests
      - [ ] Generate walkthrough

      ### Files Changed So Far

      Created: {created-count}
      Modified: {modified-count}

      ### Recent Activity

      {last 5 actions}
    </output>
  </step>
</flow>

<example_output>

  ```
  ## Run Status: run-fabriqa-2026-003

  **Work Item**: Add session management
  **Intent**: User Authentication
  **Mode**: confirm
  **Started**: 2026-01-19T10:30:00Z
  **Duration**: 12 minutes

  ### Progress

  - [x] Initialize run
  - [x] Load context
  - [x] Plan approved (Checkpoint 1)
  - [~] Execute implementation
  - [ ] Run tests
  - [ ] Generate walkthrough

  ### Files Changed So Far

  Created: 2
  Modified: 1

  ### Recent Activity

  - Created src/auth/session.ts
  - Created src/auth/session.test.ts
  - Modified src/auth/index.ts
  ```

</example_output>

<success_criteria>
  <criterion>Current run status displayed</criterion>
  <criterion>Progress indicators accurate</criterion>
  <criterion>Files changed shown</criterion>
</success_criteria>

More from fabriqaai/specs.md

SkillDescription
design-doc-generateGenerate design documents for Validate mode work items (Checkpoint 1). Required for high-complexity items.
flameMulti-perspective idea evaluation using Six Hats analysis, impact/feasibility scoring, and collaborative shortlisting.
intent-captureCapture user intent through guided conversation. Exploratory phase with high degrees of freedom.
project-initInitialize a new FIRE project by detecting workspace type and setting up standards.
routeAnalyze project state and route user to the appropriate agent based on current context.
run-executeExecute work items based on their assigned mode (autopilot, confirm, validate). Supports single-item and multi-item (batch/wide) runs.
run-planPlan the scope of a run by discovering available work items and suggesting groupings. Invoked before run-execute.
sparkRapid idea generation with cross-domain diversity, anti-bias enforcement, and deep thinking.
walkthrough-generateGenerate implementation walkthrough for human review after run completion. Documents decisions, changes, and verification steps.
work-item-decomposeBreak an intent into discrete, executable work items with complexity assessment and dependency validation.