release-metrics

Generate Markdown and HTML metrics reports aggregating story audit data across a release or sprint.

1|Updated Jun 27, 2026
One-click install
npx skills add https://github.com/vickysrawat/AI-Assisted-development --skill release-metrics-vickysrawat
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: release-metrics
Source: https://github.com/vickysrawat/AI-Assisted-development/tree/main/skills/release-metrics
Command: npx skills add https://github.com/vickysrawat/AI-Assisted-development --skill release-metrics-vickysrawat

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Teams running ICEA-driven development accumulate audit files, trackers, and ledgers per story, but have no consolidated view of quality trends, revision depth, or recurring issues across a release. This Skill aggregates those scattered artefacts into two shareable reports. ## Core Features & Use Cases - Dual-format reporting: Produces a Markdown report with Mermaid diagrams for repos and wikis, plus a self-contained HTML report with inline Chart.js for offline stakeholder sharing. - Per-story and aggregate metrics: Parses ai-audit.md, tracker.md, icea.md, and code-review/security ledgers to compute revision counts, phase durations, follow-ups, build issues, rework rate, and optional token usage. - Trend and lessons analysis: Compares against previous release reports for trend deltas and synthesizes recurring lessons-learned themes into a Pareto chart. - Use Case: After completing Release 3, run the metrics command to get an executive summary table, quality radar, and lessons mindmap covering all ADOs in the release. ## Quick Start Ask the assistant to generate release metrics by saying "METRICS RELEASE-3" or request lessons learned for a specific release and sprint.

Frequently Asked Questions about release-metrics

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

FAQPage Schema
How do I generate a release metrics report?

Trigger the skill with a command like "METRICS RELEASE-3", optionally adding a sprint ("METRICS RELEASE-3 SPRINT-12") or comparison ("VS RELEASE-2"). It writes a Markdown file with Mermaid diagrams and an HTML file with Chart.js charts to the release-metrics/ directory.

What data sources does release metrics aggregation use?

It parses ai-audit.md event tables, tracker.md follow-ups and lessons, icea.md story points and acceptance criteria, plus code-review and security ledgers. Every number comes from a parsed file; missing data is reported as N/A rather than fabricated.

Does the HTML report need internet access to display charts?

No. Chart.js 4.4.3 is vendored with the plugin and embedded inline into the generated HTML, so the report is fully self-contained and can be shared via email or SharePoint without any external dependencies.

Why is the token analysis section missing from my report?

Token charts require ISO timestamps in ai-audit.md phase events and matching Claude session JSONL files. If timestamps or session files are unavailable, token values are set to null and the report notes that token data is not available.

What happens if chart.min.js is missing from the plugin?

The skill stops immediately with a corrupted-install error before collecting any data. You repair it by running /setup-sync or executing node fetch-vendor.js in the vendor directory to re-download Chart.js 4.4.3.