pi-seo-health-monitor

Analyze Pi-SEO scan history to detect portfolio health regressions and systemic issues.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/CleanExpo/Pi-Dev-Ops --skill pi-seo-health-monitor
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: pi-seo-health-monitor
Source: https://github.com/CleanExpo/Pi-Dev-Ops/tree/main/skills/pi-seo-health-monitor
Command: npx skills add https://github.com/CleanExpo/Pi-Dev-Ops --skill pi-seo-health-monitor

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill prevents hidden degradation in engineering quality by analyzing scan history across monitored repos and turning it into actionable portfolio-level alerts.

Core Features & Use Cases

  • Portfolio health trend scoring: Computes a weighted composite health score across projects using each project's scan_priority.
  • Regression and sustained degradation detection: Flags score drops (including critical drops) and persistent underperformance across multiple scan cycles.
  • Systemic issue identification: Detects cross-repo repeat findings by matching scan_type + title appearing in multiple projects within the same cycle.
  • Digest generation for operators: Produces an operator-friendly Markdown digest plus structured JSON output containing alerts, regressions, project deltas, and systemic issues.

Quick Start

Run the Pi-SEO health monitor to analyze .harness/scan-results/ and generate a dated digest that highlights critical regressions, systemic cross-repo issues, and portfolio health changes.

Frequently Asked Questions about pi-seo-health-monitor

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

FAQPage Schema
How do I detect code health regressions across multiple repositories?

Detecting code health regressions across multiple repositories involves analyzing Pi-SEO scan history to compare consecutive scan cycles. This process flags portfolio health drops, sustained degradation, and systemic cross-repo issues by reading stored JSON scan results per project.

What is portfolio health trend scoring and how does it work?

Portfolio health trend scoring computes a weighted composite health score across monitored projects using each project's individual scan priority. It evaluates scan history data to establish performance baselines and identify sustained degradation trends across multiple monitoring cycles.

How do I identify systemic cross-repo issues in a multi-project repository?

Identifying systemic cross-repo issues in a multi-project repository requires matching scan type and title combinations that appear across multiple projects within the same scan cycle. This detects repeat findings that indicate widespread portfolio-level problems rather than isolated incidents.

Can I generate alert digests from JSON scan results for operators?

Yes, generating alert digests from JSON scan results involves computing weighted portfolio health and emitting both structured JSON summaries and Markdown formatted alerts. The Markdown digest provides an operator-friendly format highlighting critical regressions and systemic issues.

Does portfolio health monitoring require specific scan history file formats?

Portfolio health monitoring requires scan results stored as JSON files per project and scan type across consecutive dates for trend comparison. It needs the latest two cycles per scan type to detect deltas and additional history loaded for sustained trend detection.

What's the best way to track engineering quality degradation over time?

Tracking engineering quality degradation over time is best achieved by analyzing historical scan data to compute weighted portfolio health scores and flag persistent underperformance. This approach prevents hidden degradation by turning multi-cycle scan history into actionable portfolio-level alerts.