# diagnostics-report-analyzer-skill

> Claude/Codex skill by [@avdlee](https://omgskills.com/library/avdlee/index.md) · 1.3k stars · Updated 2026-07-26

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.

Tags: swift

## Install

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

## 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.

## Links

- HTML page: https://omgskills.com/skills/avdlee/diagnostics/diagnostics-report-analyzer-skill/
- GitHub: https://github.com/AvdLee/Diagnostics
- Author: [@avdlee](https://omgskills.com/library/avdlee/index.md)

## More skills by this author

- [swiftui-expert-skill](https://omgskills.com/skills/avdlee/swiftui-agent-skill/swiftui-expert-skill/index.md) — Used when writing, reviewing, or refactoring SwiftUI code for iOS or macOS, including state management and...
   - [@avdlee](https://omgskills.com/library/avdlee/index.md) · 3.5k stars
- [update-swiftui-apis](https://omgskills.com/skills/avdlee/swiftui-agent-skill/update-swiftui-apis/index.md) — Scan Apple's SwiftUI documentation for deprecated APIs and update the SwiftUI Expert Skill with modern replacements.
   - [@avdlee](https://omgskills.com/library/avdlee/index.md) · 3.5k stars
- [swift-concurrency](https://omgskills.com/skills/avdlee/swift-concurrency-agent-skill/swift-concurrency/index.md) — Diagnose Swift Concurrency issues, refactor callback-based code to async/await, and guide Swift 6 migration when...
   - [@avdlee](https://omgskills.com/library/avdlee/index.md) · 1.6k stars