wrkx-status

Generate per-repo health snapshots with branch status and divergence into .wrkx/repos.md.

Updated Apr 8, 2026
One-click install
npx skills add https://github.com/ClankerGuru/opsx --skill wrkx-status
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: wrkx-status
Source: https://github.com/ClankerGuru/opsx/tree/main/cli/src/main/resources/content/skills/wrkx-status
Command: npx skills add https://github.com/ClankerGuru/opsx --skill wrkx-status

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill generates a per-repo health snapshot for workspace repositories, capturing the current branch, uncommitted changes, and divergence indicators to help teams quickly assess health.

Core Features & Use Cases

  • Per-repo health snapshot: reports the current branch, dirty state, ahead/behind counts, and divergence for each repo, and writes the results to .wrkx/repos.md.
  • On-demand health checks: activates when a user requests a health check, status overview, or workspace health audit across all wrkx-tracked repos.
  • Automated reporting: produces a consolidated Markdown file suitable for reviews, dashboards, or archival records.

Quick Start

Run the wrkx-status task to generate the workspace health report for all tracked repositories.

Frequently Asked Questions about wrkx-status

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

FAQPage Schema
How do I generate a workspace health report for multiple git repositories?

To generate a workspace health report, run the wrkx-status task to read the wrkx.json manifest, compute current branch, uncommitted changes, and ahead/behind divergence for each repo, then write the consolidated results to a Markdown file.

What is a per-repo health snapshot and what does it include?

A per-repo health snapshot captures the current branch, dirty state, uncommitted changes, ahead/behind counts against origin, and divergence indicators for each workspace repository to help teams quickly assess health.

How do I check git status across all tracked repositories at once?

You can check git status across all tracked repositories by running the wrkx-status task, which computes branch and divergence data for all wrkx-tracked repos and writes a comprehensive status overview to .wrkx/repos.md.

Can I use this workspace health check with my existing git workflow?

Yes, the workspace health check works with existing git workflows by reading the wrkx.json manifest to identify repositories, computing standard git metrics like uncommitted changes and origin divergence, and outputting a Markdown report suitable for reviews or dashboards.

What's the best way to audit uncommitted changes and branch divergence across repositories?

The best way to audit uncommitted changes and branch divergence is to run the wrkx-status task, which automatically computes these metrics across all wrkx-tracked repositories and consolidates them into a single Markdown report for archival or review.

Where does the workspace health report get saved?

The workspace health report gets saved to .wrkx/repos.md as a consolidated Markdown file, containing the per-repo health snapshot with branch, dirty state, and divergence data for all tracked repositories.