audit-trends

Aggregate audit snapshots into trend reports with health scores and MTTR.

Updated May 5, 2026
One-click install
npx skills add https://github.com/shakhovskiya-create/shakhoff-claude-marketplace --skill audit-trends
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: audit-trends
Source: https://github.com/shakhovskiya-create/shakhoff-claude-marketplace/tree/main/plugins/sdlc-audit/skills/audit-trends
Command: npx skills add https://github.com/shakhovskiya-create/shakhoff-claude-marketplace --skill audit-trends

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Aggregates audit snapshots from docs/audit/* into trend reports, enabling teams to see how findings evolve over time and identify patterns in risk and remediation.

Core Features & Use Cases

  • Historical trend analysis: aggregates per-snapshot findings to compute new, fixed, reopened, and lingering items.
  • Health scoring & MTTR: derives a per-snapshot health score and median time-to-resolution across severities for prioritization.
  • Regression detection: detects phase regressions and provides a time-series view to guide remediation planning.
  • Use Case: a security/audit team reviews quarterly audit data to surface deterioration or improvements and adjust remediation plans.

Quick Start

Run a trend aggregation over the docs/audit directory to produce the trend report for the latest snapshot.

Frequently Asked Questions about audit-trends

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

FAQPage Schema
How do I track audit findings trends over time using JSON snapshots?

To track audit findings trends over time, you aggregate timestamped JSON snapshots from your audit directory to compute new, fixed, reopened, and lingering findings. This process maintains per-finding histories using first_seen and last_seen timestamps to produce a structured trend report.

How does calculating MTTR per severity help with audit health analysis?

Calculating MTTR per severity helps with audit health analysis by deriving the median time-to-resolution across different severity levels. This metric, combined with a per-window health score, enables teams to prioritize remediation efforts and identify patterns in risk and resolution speed.

Can I use audit snapshot data to detect security regressions?

Yes, you can use audit snapshot data to detect security regressions. By applying historical trend analysis across timestamped snapshots, the system identifies phase regressions and provides a time-series view to guide and adjust your remediation planning accordingly.

Do I need a specific schema to validate my audit findings JSON files?

Yes, you need a specific schema to validate your audit findings JSON files. The trend aggregation requires loading findings JSON files from the audit directory and validating them against the audit-finding.schema.json file before processing the historical data.

What is the best way to generate an audit health score from historical snapshots?

The best way to generate an audit health score from historical snapshots is to aggregate timestamped findings data and compute new, fixed, and lingering items per window. This yields a per-snapshot health score that surfaces deterioration or improvements over time.