Build Doctor

Automates Flutter clean, pub get, build workflow and diagnoses Gradle, Pod, Pub errors.

Updated Aug 11, 2025
One-click install
npx skills add https://github.com/NinaVerde/ninaverde_app --skill build-doctor
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: Build Doctor
Source: https://github.com/NinaVerde/ninaverde_app/tree/main/.agent/skills/build-doctor
Command: npx skills add https://github.com/NinaVerde/ninaverde_app --skill build-doctor

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill automates the tedious Flutter hard restart workflow (clean -> pub get -> build) and streamlines the diagnosis of common build failures.

Core Features & Use Cases

  • Automated Clean and Build: runs flutter clean, flutter pub get, and flutter build apk --debug to ensure a fresh start.
  • Built-in Diagnostics: detects Gradle (android/build.gradle), Pod (ios/Podfile.lock), and Pub Get errors and suggests fixes.
  • Verification & Launch: confirms the app can launch on a connected device or emulator before reporting success.

Quick Start

Run the Build Doctor in your Flutter project to perform flutter clean, flutter pub get, and a debug build.

Frequently Asked Questions about Build Doctor

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

FAQPage Schema
How do I automate a Flutter hard restart workflow?

Automate a Flutter hard restart by running a clean, pub get, and debug build sequence. This workflow executes flutter clean, flutter pub get, and flutter build apk --debug to ensure a fresh project start and verify the app compiles successfully.

Why does my Flutter build fail after running flutter clean and pub get?

Flutter builds fail after a clean due to Gradle, Pod, or Pub Get configuration errors. Built-in diagnostics detect issues in android/build.gradle, ios/Podfile.lock, and pubspec.yaml, analyzing the failure logs to suggest actionable fixes for your project setup.

How can I diagnose Gradle and Pod errors in my Flutter project?

Diagnose Gradle and Pod errors by checking the android/build.gradle and ios/Podfile.lock files for configuration issues. Automated diagnostics scan these files and build outputs to identify common failure scenarios during development and release cycles, suggesting fixes.

Does the automated Flutter hard restart workflow support both Android and iOS?

The automated Flutter hard restart workflow supports both Android and iOS projects. It checks for android/build.gradle and ios/Podfile.lock to handle platform-specific Gradle and Pod failure scenarios, applying deterministic task execution across both platforms.

Can I verify that my Flutter app launches on a device after a clean build?

You can verify your Flutter app launches on a connected device or emulator after the clean build process completes. The workflow confirms the app can successfully launch before reporting success, ensuring your project is fully functional.