trw-project-health

Aggregate TRW analytics, hook logs, learnings, and runs into a markdown health report.

Updated Mar 25, 2026
One-click install
npx skills add https://github.com/wallter/trw-mcp --skill trw-project-health
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: trw-project-health
Source: https://github.com/wallter/trw-mcp/tree/main/src/trw_mcp/data/codex/skills/trw-project-health
Command: npx skills add https://github.com/wallter/trw-mcp --skill trw-project-health

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Audits TRW health by summarizing ceremony compliance, hook enforcement, active runs, and learnings across a project, helping teams spot gaps and improve governance.

Core Features & Use Cases

  • Aggregate TRW metrics from analytics, hook logs, learnings, and runs to produce a health snapshot.
  • Identify ceremony compliance gaps, hook enforcement patterns, and active issues for targeted improvements.
  • Generate a structured, shareable health report suitable for team reviews and project retrospectives.

Quick Start

Run the health audit on the current project or a target path to generate a TRW health report.

Frequently Asked Questions about trw-project-health

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

FAQPage Schema
How do I audit project health and ceremony compliance from YAML and JSON telemetry data?

To audit project health, you aggregate ceremony compliance, hook enforcement, and learnings from YAML and JSON telemetry data. This process reads hook logs and active runs to produce a structured markdown report highlighting governance gaps.

What is a project health audit and what does the generated report include?

A project health audit summarizes ceremony compliance, hook enforcement patterns, and active issues across a project. The generated report provides a structured health snapshot by counting events from analytics and learnings, suitable for team reviews.

How do I generate a health report for a project with a .trw directory?

Generating a health report for a project with a .trw directory involves running a health audit on the target path. The audit reads YAML and JSON sources, counts telemetry events, and summarizes issues into a markdown health report.

Can I use this audit to identify hook enforcement patterns and active issues?

Yes, you can use this audit to identify hook enforcement patterns and active issues. It aggregates metrics from hook logs and active runs, summarizing governance gaps to help teams spot compliance issues for targeted improvements.

Does the health audit work without external dependencies to read analytics and learnings?

Yes, the health audit works without external dependencies to read analytics and learnings. It natively parses YAML and JSON sources to count events and summarize issues into a structured markdown report covering ceremonies and hooks.

Why should I aggregate TRW metrics instead of manually checking hook logs and learnings?

Aggregating TRW metrics instead of manually checking hook logs and learnings provides a consolidated health snapshot. It automatically identifies ceremony compliance gaps and active issues, streamlining governance reviews and project retrospectives into a shareable report.