reflex-audit

Score reflex-chain workflow health from trigger-stats.json and historical runs.

1|Updated Mar 27, 2026
One-click install
npx skills add https://github.com/rongarede/claude-skills-orchestration --skill reflex-audit
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: reflex-audit
Source: https://github.com/rongarede/claude-skills-orchestration/tree/main/skills/reflex-audit
Command: npx skills add https://github.com/rongarede/claude-skills-orchestration --skill reflex-audit

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Reflex audit identifies weaknesses in a reflex-chain workflow by analyzing trigger statistics and historical run records, then produces prioritized improvement actions or performs a targeted quick repair when a specific problem is reported.

Core Features & Use Cases

  • Full audit with scored health report: Evaluates coverage, failure recovery, efficiency, balance, circuit-breaker (CB) health, and definition consistency, then outputs a structured audit report.
  • Instant quick fix workflow: Interprets a user-described issue, pinpoints the relevant reflection and underlying failure mode, applies a repair plan, and validates via targeted end-to-end tests.
  • Practical data-driven iteration: Uses trigger-map definitions, trigger-stats.json, and workflow runs history to ground changes in observed system behavior.

Quick Start

Run full auditing and improvement by asking your agent to execute the /reflex-audit trigger, review the generated report, and then proceed with applying the recommended changes.

Frequently Asked Questions about reflex-audit

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

FAQPage Schema
How do I audit reflex chains to diagnose failing reflection behavior?

Auditing reflex chains involves scoring trigger usage, failure recovery, and consistency from trigger-stats.json and historical workflow runs. It computes weighted dimension scores and produces a prioritized report for scheduled system reviews and post-incident diagnosis.

What is the best way to fix an imbalanced reflex-chain workflow without losing historical counters?

Fixing an imbalanced reflex-chain workflow requires applying targeted repairs to the relevant workflow documents and circuit breaker state. The process preserves historical counters while addressing the underlying failure mode identified during the audit.

How do I perform a quick repair on a specific reflex-chain failure mode?

Performing a quick repair involves interpreting the reported issue, pinpointing the relevant reflection, applying a repair plan, and validating via targeted end-to-end tests. It uses trigger-map definitions and trigger-stats.json to ground changes in observed behavior.

Can I use a reflex audit for scheduled system reviews of trigger coverage?

Yes, reflex audits apply to scheduled system reviews by evaluating trigger coverage, efficiency, and definition consistency. It reads SSOT trigger-map definitions and historical workflow runs to generate a structured health report.

What data do I need to assess circuit breaker health in a reflex-chain workflow?

Assessing circuit breaker health requires trigger-stats.json, SSOT trigger-map definitions, and historical workflow runs. These inputs allow the audit to score CB health alongside failure recovery and workflow balance dimensions.

Why does my reflex-chain workflow show imbalanced trigger usage after an incident?

Imbalanced trigger usage after an incident indicates failing or imbalanced reflection behavior. An audit computes weighted dimension scores from trigger-stats.json and historical runs to pinpoint weaknesses and recommend targeted improvements.