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.