debug:flutter

Diagnose Flutter errors across Android, iOS, and Web with DevTools.

9|1|Updated Jan 12, 2026
One-click install
npx skills add https://github.com/SnakeO/claude-debug-and-refactor-skills-plugin --skill debug-flutter
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: debug:flutter
Source: https://github.com/SnakeO/claude-debug-and-refactor-skills-plugin/tree/main/plugins/debug-and-refactor/skills/debug-flutter
Command: npx skills add https://github.com/SnakeO/claude-debug-and-refactor-skills-plugin --skill debug-flutter

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill provides a structured approach to diagnosing and debugging Flutter applications, helping developers identify and fix issues efficiently.

Core Features & Use Cases

  • Systematic error identification: render and runtime error patterns (e.g., RenderFlex overflow, setState after dispose)
  • Tooling guidance: Flutter DevTools, widget inspector, performance and memory profiling
  • Platform-specific debugging: Android, iOS, and Web targets with platform logs and debugging tips
  • Best practices: stable state management debugging, hot reload troubleshooting, and error handling patterns

Quick Start

Run through the four-phase Flutter debugging workflow on your project:

  • Identify the error type using Phase 1 guidelines.
  • Reproduce and isolate the issue with minimal code.
  • Debug and fix with targeted DevTools breakpoints and widget inspector.
  • Verify the fix with lightweight tests and regression checks.

Frequently Asked Questions about debug:flutter

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

FAQPage Schema
How do I debug a RenderFlex overflow error in Flutter?

Debug a Flutter RenderFlex overflow by using the widget inspector to locate the constraint violation and applying targeted fixes. The systematic workflow isolates the rendering issue with minimal code before verifying the UI fix with regression checks.

Why does my Flutter app throw a setState after dispose error?

A setState after dispose error occurs when Flutter state updates trigger after a widget leaves the tree. Diagnose this runtime error pattern by setting DevTools breakpoints and implementing stable state management debugging practices to guard lifecycle calls.

What is the best way to profile Flutter performance issues?

The best way to profile Flutter performance issues is using Flutter DevTools for performance and memory profiling. This identifies UI jank and allocation bottlenecks across Android, iOS, and Web platforms through a structured four-phase debugging workflow.

How do I troubleshoot Flutter hot reload failures?

Troubleshoot Flutter hot reload failures by following best practices for stable state management and error handling patterns. Isolate the state corruption with minimal code reproduction, then apply targeted fixes and verify functionality with lightweight tests.

Can I use Flutter DevTools to debug platform-specific issues on iOS and Android?

Yes, Flutter DevTools supports debugging platform-specific issues across Android, iOS, and Web targets. The workflow integrates platform logs and platform-specific debugging practices to isolate null check operator errors and runtime exceptions.

How do I fix null check operator errors in Flutter?

Fix null check operator errors in Flutter by reproducing the runtime issue with minimal code and setting DevTools breakpoints. Identify the null variable access pattern, apply safe null handling, and verify the fix with lightweight regression checks.