omgskills Get the Mac app
Skill

diagnostics-report-analyzer-skill

@avdlee 1.3k stars Updated 2026-07-10 Author match: High

Analyze AvdLee Diagnostics HTML reports for customer support and debugging. Use this skill whenever the user asks to inspect, summarize, triage, debug, or explain a Diagnostics-Report.html attachment, Diagnostics session logs, embedded diagnostics JSON, legacy HTML-only reports, MetricKit crash diagnostics, app/system metadata, or support reports generated by the Diagnostics framework.

swift

Install

Install this Claude and Codex skill with the command below. The command stays visible even when copy support is unavailable.

Install command
git clone https://github.com/AvdLee/Diagnostics /tmp/Diagnostics && ln -s /tmp/Diagnostics/diagnostics-report-analyzer-skill ~/.claude/skills/diagnostics-report-analyzer-skill

View on GitHub

From README

Diagnostics Report Analyzer Skill Use this skill to analyze single-file reports generated by the AvdLee Diagnostics framework. These reports are usually emailed as .html attachments and may contain either structured JSON plus a browser renderer or older pre-rendered HTML only. Core Principle Treat the report as diagnostic evidence, not as a webpage to summarize. Newer reports are intentionally designed for agents: they contain a structured JSON payload that is more precise and token-efficient than the rendered HTML. Analysis Workflow Prefer Embedded JSON If the report contains this element, extract and parse its text content: Use that JSON as the source of truth. Ignore CSS, JavaScript, navigation markup, and rendered HTML unless a chapter explicitly uses legacyHTML. Expected top-level fields: schemaVersion: report schema version. title: human-readable report title. agentHints: producer-provided analysis hints. chapters: report sections.

More skills