workflow-audit

Analyze evolution data to generate a structured workflow health report.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/vinicius91carvalho/.claude --skill workflow-audit-vinicius91carvalho
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: workflow-audit
Source: https://github.com/vinicius91carvalho/.claude/tree/main/skills/workflow-audit
Command: npx skills add https://github.com/vinicius91carvalho/.claude --skill workflow-audit-vinicius91carvalho

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Periodic self-audit of the workflow system to assess rule effectiveness, model performance, error patterns, and configuration staleness. This guide explains how to run a monthly health check or on demand when the user asks to audit the workflow, review the system, or check workflow health.

Core Features & Use Cases

  • Assess evolution data from ~/.claude/evolution/ to determine whether the workflow is improving, stagnating, or accumulating dead weight.
  • Identify recurring errors, stale or conflicting rules, and opportunities for optimization.
  • Produce a structured health report with actionable recommendations and traceable evidence for leadership and engineering teams.

Quick Start

Run the workflow-audit command to generate the latest health report from evolution data.

Frequently Asked Questions about workflow-audit

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

FAQPage Schema
How do I audit workflow health and check for stale rules in Claude?

To audit workflow health, analyze evolution artifacts like error-registry.json, model-performance.json, and session-postmortems to measure effectiveness, detect staleness, and identify optimization opportunities. The audit generates a structured health report with actionable recommendations and traceable evidence.

What is workflow system auditing and when do I need to run it?

Workflow system auditing is a periodic self-audit assessing rule effectiveness, model performance, error patterns, and configuration staleness. Run it monthly or on demand to determine whether your workflow is improving, stagnating, or accumulating dead weight across evolution artifacts.

How do I identify recurring error patterns from session postmortems?

Identify recurring error patterns by analyzing error-registry.json and session-postmortems/ directories. The audit enforces guardrails by flagging recurring errors and citing data-backed evidence without making automated changes without user approval.

Can I review model performance data without automated changes to my configuration?

Yes, you can review model performance data from model-performance.json safely. The audit must cite data-backed evidence and avoids making automated changes without explicit user approval, ensuring you control all configuration modifications.

What's the best way to assess if my workflow rules are stagnating?

The best way to assess workflow stagnation is analyzing evolution data across CLAUDE.md, MEMORY.md, and workflow-changelog.md. This detects stale or conflicting rules and produces a structured health report with optimization opportunities for engineering teams.

Does the workflow audit require any dependencies or external components?

No, the workflow audit requires no external dependencies or components. It operates directly on existing evolution artifacts within the ~/.claude/ directory structure to generate health reports and flag low-performance areas.