flutter-reviewer_skill

Overview

This skill reviews Flutter and Dart code for widget patterns, state management, performance, and platform channel issues. It highlights risky patterns, suggests concrete fixes, and targets BLoC, Provider, Riverpod, and other common Flutter state solutions. Use it to get actionable, prioritised recommendations on code quality and runtime safety.

How this skill works

The skill scans a Flutter project (pubspec.yaml, lib/, android/, ios/) and analyzes .dart files for build-time anti-patterns, state management lifecycle problems, performance hotspots, and platform channel safety. It reports severity-tagged issues (CRITICAL / HIGH / MEDIUM) and provides concise remediation steps and code examples. You can request focused checks (widgets, state, performance, platform channels) or a full review.

When to use it

• Performing code review on a Flutter project (pubspec.yaml contains flutter:)
• Auditing widget build methods for heavy logic or missing consts
• Validating BLoC/Provider/Riverpod usage and lifecycle management
• Investigating performance issues: rebuilds, images, I/O, animations
• Reviewing platform channel implementations and native interop safety

Best practices

• Keep build() lightweight: compute expensive work in initState or memoize results
• Mark immutable widgets const and extract large build methods into smaller widgets
• Close/dispose state objects: bloc.close(), Provider disposal, AnimationController.dispose()
• Use context.watch/select or BlocSelector to avoid unnecessary rebuilds and nested builders
• Offload heavy CPU or file I/O to compute()/Isolate and cache large images

Example use cases

• Full project review to prioritize fixes before release
• Spot-check a screen with frequent rebuilds and jank to identify root causes
• Audit BLoC instances for missing close() calls and unsafe emits after dispose
• Verify Riverpod setup (ProviderScope present) and ChangeNotifier notifyListeners usage
• Review platform channel code for null checks, error handling, and main-thread blocking