diagnostics-and-tooling

Decode minified Flutter web crash stacks to original Dart source lines.

2|3|Updated Nov 28, 2025
One-click install
npx skills add https://github.com/richardthe3rd/cambridge-beer-festival-app --skill diagnostics-and-tooling
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: diagnostics-and-tooling
Source: https://github.com/richardthe3rd/cambridge-beer-festival-app/tree/main/.claude/skills/diagnostics-and-tooling
Command: npx skills add https://github.com/richardthe3rd/cambridge-beer-festival-app --skill diagnostics-and-tooling

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires source-map, and includes scripts (resource) components.

What problem does it solve?

This Skill eliminates guesswork when assessing the health, performance, and correctness of the Cambridge Beer Festival Flutter app, replacing subjective eyeballing of test results, crash traces, and toolchain behavior with concrete, reproducible measurements from official project tooling.

Core Features & Use Cases

  • Test and analyze log capture: Run Flutter test and analyze tasks, capture their full output to timestamped log files, and grep for failures, errors, or warnings without re-running entire test suites.
  • Production crash stack decoding: Decode minified Flutter web crash stacks from production or CI builds back to original Dart source file and line numbers, with built-in handling for CI vs local line offsets.
  • Coverage triage: Summarize lcov coverage reports to identify under-covered source files, aligned with the project's 70% Codecov project and patch thresholds.
  • Headless page and console probing: Run headless Chromium checks for page load success, capture full-page screenshots, and flag console errors for e2e test validation.
  • Toolchain issue diagnosis: Use mise introspection commands to isolate whether task failures stem from code issues or misconfigured toolchain versions and environments. Use case example: If a CI e2e test fails with a minified web stack trace, use this skill to decode the stack to the exact Dart file and line causing the crash, or if a PR's coverage drops below the Codecov gate, use the lcov summary to identify which new or modified files lack test coverage.

Quick Start

Use the diagnostics-and-tooling skill to decode a minified Flutter web crash stack from a production CI build to find the exact Dart source file and line causing the error.

Frequently Asked Questions about diagnostics-and-tooling

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

FAQPage Schema
How do I decode a minified Flutter web crash stack from a production CI build?

Decode a minified Flutter web crash stack by using source-map tooling to translate the stack traces back to original Dart source file names and line numbers, automatically handling CI versus local line offsets.

How do I summarize lcov coverage reports to find files below the 70% Codecov threshold?

Summarize lcov coverage reports by parsing the coverage data to identify under-covered source files, triaging results against the project's 70% Codecov project and patch thresholds.

Can I capture Flutter test and analyze logs to grep for failures without re-running the suite?

Yes, you can capture Flutter test and analyze logs by directing the full output to timestamped log files, allowing you to grep for failures, errors, or warnings without re-running the entire test suite.

Does mise introspection help isolate Flutter toolchain configuration issues?

Yes, mise introspection helps isolate Flutter toolchain configuration issues by examining the environment to determine whether task failures stem from code issues or misconfigured toolchain versions.

What is the best way to probe headless Chromium page loads and console errors for Flutter e2e tests?

The best way to probe headless Chromium page loads is to run headless checks that validate page load success, capture full-page screenshots, and flag console errors for e2e test validation.