harness-observability

Parse structured snapshots to compute cadence trends and meta-observability checks.

44|6|Updated Mar 30, 2026
One-click install
npx skills add https://github.com/Habitat-Thinking/ai-literacy-superpowers --skill harness-observability
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: harness-observability
Source: https://github.com/Habitat-Thinking/ai-literacy-superpowers/tree/main/ai-literacy-superpowers/skills/harness-observability
Command: npx skills add https://github.com/Habitat-Thinking/ai-literacy-superpowers --skill harness-observability

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Provides a structured, evidence-based way to verify that a project's harness is actually running, tracking operational cadences, surfacing trends between snapshots, and detecting when observability itself is failing so teams can act before drift accumulates.

Core Features & Use Cases

  • Operational cadence checks that verify scheduled mechanisms (audit, GC, reflection, mutation testing) actually executed and surface overdue activities.
  • Trend computation by diffing human-readable snapshots to highlight deltas and multi-period trends for reviews.
  • Telemetry export guidance and a reference export script to emit OpenTelemetry metrics for external dashboards.
  • Meta-observability: five automated checks (snapshot currency, cadence compliance, learning flow, GC effectiveness, trend direction) that feed a README health badge and meta section.
  • Use Case: Run a harness snapshot before a quarterly review to baseline enforcement ratio, mutation trends, and learning promotions, then export metrics to Grafana.

Quick Start

Run the /harness-health command to generate the latest snapshot, compute trends against the previous snapshot, and update the README health badge.

Frequently Asked Questions about harness-observability

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

FAQPage Schema
How do I verify my CI harness is actually running scheduled audits and garbage collection?

Harness observability performs operational cadence checks to verify scheduled mechanisms like audits and GC actually executed, surfacing overdue activities so teams can act before drift accumulates.

How do I compute trends from file-based snapshots for a quarterly review?

Compute trend tables by diffing human-readable snapshots to highlight deltas and multi-period trends, providing an evidence-based baseline of enforcement ratios and mutation trends for reviews.

Can I export telemetry metrics from my harness snapshots to OpenTelemetry?

Yes, the Skill provides telemetry export guidance and a reference script to emit OpenTelemetry metrics via OTLP, allowing you to send operational cadence and trend data to external dashboards like Grafana.

What is meta-observability and how does it detect observability failures?

Meta-observability runs five automated checks covering snapshot currency, cadence compliance, learning flow, GC effectiveness, and trend direction to detect when the observability layer itself is failing.

Does this observability tool require any specific dependencies or external platforms?

No, the Skill operates with zero dependencies, parsing structured snapshot files natively and providing optional OpenTelemetry export scripts without requiring external platforms to function.

How do I generate a health badge for my project's README to show harness status?

Run the health command to generate a snapshot, compute trends, and evaluate five meta-observability checks, which automatically format results into a README health badge and meta section.