Agent skill

Flutter Add Integration Test

by abdulmominsakib in abdulmominsakib/localmind

Configures Flutter Driver for app interaction and converts MCP actions into permanent integration tests.

MITAuto-check passedTesting & QA

Install Flutter Add Integration Test

skills CLI
$ npx skills add abdulmominsakib/localmind --skill flutter-add-integration-test -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install abdulmominsakib/localmind flutter-add-integration-test --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/abdulmominsakib/localmind.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/flutter-add-integration-test .claude/skills/flutter-add-integration-test && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
flutter-add-integration-test
GitHub stars
268
Token cost
~1.8k tokens
SKILL.md length
526 words
Files
1
Skills in repo
13
Repo updated
First seen
Licence
MIT

At a glance

Configures Flutter Driver for app interaction and converts MCP actions into permanent integration tests.

  • Works in 3 steps: Add required development dependencies to… → Enable the Flutter Driver extension in… → Add Key parameters (e.g.,…
  • Adding integration testing to a project
  • SKILL.md covers Contents, Project Setup and Dependencies, Interactive Exploration via MCP and Test Authoring Guidelines, plus 3 more sections
  • Calls flutter

What it does

Flutter Add Integration Test is an agent skill from abdulmominsakib/localmind. Configures Flutter Driver for app interaction and converts MCP actions into permanent integration tests. Use when adding integration testing to a project, exploring UI components via MCP, or automating user flows with the integrationtest package.

Its SKILL.md is about 1.8k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Testing & QA, covering Integration testing and Cross-platform mobile apps. It works with Flutter, Model Context Protocol and Dart. The repository describes itself as: A mobile application designed to provide a beautiful, fast, and privacy-respecting interface for on device LLM and local LLM servers and cloud providers. The licence is MIT.

When your agent uses it

  • Adding integration testing to a project
  • Exploring UI components via MCP
  • Automating user flows with the integrationtest package

Example prompts

  • “Use the flutter-add-integration-test skill to configure Flutter Driver for app interaction and converts MCP actions into permanent integration tests”
  • “/flutter-add-integration-test”

Workflow steps

3 steps, taken from the first numbered list in SKILL.md.

  1. Add required development dependencies to pubspec.yaml
  2. Enable the Flutter Driver extension in your application entry point (typically lib/main.dart or a dedicated lib/main_test.dart)
  3. Add Key parameters (e.g., ValueKey('login_button')) to critical widgets in the application code to ensure reliable targeting during tests.

What it can do on your machine

Read from SKILL.md and the folder at commit 9ff3f94. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • flutter

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Flutter Add Integration Test loads about 1.8k tokens when it runs. Until then it costs about 69 tokens; SKILL.md has 526 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~69
When it runs · the whole SKILL.md, loaded when a task matches
~1.8k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from abdulmominsakib/localmind at commit 9ff3f94, republished under its MIT licence (© abdulmominsakib). 526 words, ~1,836 tokens.

Download SKILL.mdSave it as .claude/skills/flutter-add-integration-test/SKILL.md (or your agent's skills folder).
name
flutter-add-integration-test
description
Configures Flutter Driver for app interaction and converts MCP actions into permanent integration tests. Use when adding integration testing to a project, exploring UI components via MCP, or automating user flows with the integration_test package.
metadata.model
models/gemini-3.1-pro-preview
metadata.last_modified
Tue, 21 Apr 2026 18:29:20 GMT

Implementing Flutter Integration Tests

Contents

Project Setup and Dependencies

Configure the project to support integration testing and Flutter Driver extensions.

  1. Add required development dependencies to pubspec.yaml:
    bash
    flutter pub add 'dev:integration_test:{"sdk":"flutter"}'
    flutter pub add 'dev:flutter_test:{"sdk":"flutter"}'
  2. Enable the Flutter Driver extension in your application entry point (typically lib/main.dart or a dedicated lib/main_test.dart):
    • Import package:flutter_driver/driver_extension.dart.
    • Call enableFlutterDriverExtension(); before runApp().
  3. Add Key parameters (e.g., ValueKey('login_button')) to critical widgets in the application code to ensure reliable targeting during tests.

Interactive Exploration via MCP

Use the Dart/Flutter MCP server tools to interactively explore and manipulate the application state before writing static tests.

  • Launch: Execute launch_app with target: "lib/main_test.dart" to start the application and acquire the DTD URI.
  • Inspect: Execute get_widget_tree to discover available Keys, Text nodes, and widget Types.
  • Interact: Execute tap, enter_text, and scroll to simulate user flows.
  • Wait: Always execute waitFor or verify state with get_health when navigating or triggering animations.
  • Troubleshoot Unmounted Widgets: If a widget is not found in the tree, it may be lazily loaded in a SliverList or ListView. Execute scroll or scrollIntoView to force the widget to mount before interacting with it.

Test Authoring Guidelines

Structure integration tests using the flutter_test API paradigm.

  • Create a dedicated integration_test/ directory at the project root.
  • Name all test files using the <name>_test.dart convention.
  • Initialize the binding by calling IntegrationTestWidgetsFlutterBinding.ensureInitialized(); at the start of main().
  • Load the application UI using await tester.pumpWidget(MyApp());.
  • Trigger frames and wait for animations to complete using await tester.pumpAndSettle(); after interactions like tester.tap().
  • Assert widget visibility using expect(find.byKey(ValueKey('foo')), findsOneWidget); or findsNothing.
  • Scroll to specific off-screen widgets using await tester.scrollUntilVisible(itemFinder, 500.0, scrollable: listFinder);.

Conditional Logic for Legacy flutter_driver:

  • If maintaining or migrating legacy flutter_driver tests, use driver.waitFor(), driver.waitForAbsent(), driver.tap(), and driver.scroll() instead of the WidgetTester APIs.
Show full SKILL.md (226 more words)Show less

Execution and Profiling

Execute tests using the flutter drive command. Require a host driver script located in test_driver/integration_test.dart that calls integrationDriver().

Conditional Execution Targets:

  • If testing on Chrome: Launch chromedriver --port=4444 in a separate terminal, then run: flutter drive --driver=test_driver/integration_test.dart --target=integration_test/app_test.dart -d chrome
  • If testing headless web: Run with -d web-server.
  • If testing on Android (Local): Run flutter drive --driver=test_driver/integration_test.dart --target=integration_test/app_test.dart.
  • If testing on Firebase Test Lab (Android):
    1. Build debug APK: flutter build apk --debug
    2. Build test APK: ./gradlew app:assembleAndroidTest
    3. Upload both APKs to the Firebase Test Lab console.

Workflow: End-to-End Integration Testing

Copy and follow this checklist to implement and verify integration tests.

  • Task Progress: Setup
    • Add integration_test and flutter_test to pubspec.yaml.
    • Inject enableFlutterDriverExtension() into the app entry point.
    • Assign ValueKeys to target widgets.
  • Task Progress: Exploration
    • Run launch_app via MCP.
    • Map the widget tree using get_widget_tree.
    • Validate interaction paths using MCP tools (tap, enter_text).
  • Task Progress: Authoring
    • Create integration_test/app_test.dart.
    • Write test cases using WidgetTester APIs.
    • Create test_driver/integration_test.dart with integrationDriver().
  • Task Progress: Execution & Feedback Loop
    • Run flutter drive --driver=test_driver/integration_test.dart --target=integration_test/app_test.dart.
    • Feedback Loop: Review test output -> If PumpAndSettleTimedOutException occurs, check for infinite animations -> If widget not found, add scrollUntilVisible -> Re-run test until passing.

Examples

Standard Integration Test (integration_test/app_test.dart)
dart
import 'package:flutter/material.dart';
import 'package:flutter_test/flutter_test.dart';
import 'package:integration_test/integration_test.dart';
import 'package:my_app/main.dart';

void main() {
  IntegrationTestWidgetsFlutterBinding.ensureInitialized();

  group('End-to-end test', () {
    testWidgets('tap on the floating action button, verify counter', (tester) async {
      // Load app widget.
      await tester.pumpWidget(const MyApp());

      // Verify the counter starts at 0.
      expect(find.text('0'), findsOneWidget);

      // Find the floating action button to tap on.
      final fab = find.byKey(const ValueKey('increment'));

      // Emulate a tap on the floating action button.
      await tester.tap(fab);

      // Trigger a frame and wait for animations.
      await tester.pumpAndSettle();

      // Verify the counter increments by 1.
      expect(find.text('1'), findsOneWidget);
    });
  });
}
Host Driver Script (test_driver/integration_test.dart)
dart
import 'package:integration_test/integration_test_driver.dart';

Future<void> main() => integrationDriver();
Performance Profiling Driver Script (test_driver/perf_driver.dart)

Use this driver script if you wrap your test actions in binding.traceAction() to capture performance metrics.

dart
import 'package:flutter_driver/flutter_driver.dart' as driver;
import 'package:integration_test/integration_test_driver.dart';

Future<void> main() {
  return integrationDriver(
    responseDataCallback: (data) async {
      if (data != null) {
        final timeline = driver.Timeline.fromJson(
          data['scrolling_timeline'] as Map<String, dynamic>,
        );

        final summary = driver.TimelineSummary.summarize(timeline);

        await summary.writeTimelineToFile(
          'scrolling_timeline',
          pretty: true,
          includeSummary: true,
        );
      }
    },
  );
}

© abdulmominsakib, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in .agents/skills/flutter-add-integration-test of abdulmominsakib/localmind.

Open the folder on GitHubat commit 9ff3f94

Compare with similar skills

Flutter Add Integration Test next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Flutter Add Integration Test compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Flutter Add Integration Test this skillabdulmominsakib/localmind268—~1.8kAutomated safety check: PassMIT
Flutter TestingMADTeacher/mad-agents-skills110—~1.5kAutomated safety check: PassMIT
Specialist Integration Test GeneratorHoangNguyen0403/agent-skills-standard572—~548Automated safety check: PassMIT
Flutter MCP E2E HarnessArenukvern/mcp_flutter387—~2.2kAutomated safety check: PassMIT
Green GateVeryGoodOpenSource/vgv-ai-flutter-plugin170—~4.7kAutomated safety check: NotesMIT
Testing Strategybladeofgod/flutter-ai-harness116—~268Automated safety check: PassMIT

Similar skills

  • Flutter Testing

    MADTeacher/mad-agents-skills

    Write, fix, review, debug, and validate Flutter tests for apps, packages, and plugins.

    110 GitHub stars~1.5k tokensUpdated 5 mo ago
    Testing & QAAuto-check passed
  • Specialist Integration Test Generator

    HoangNguyen0403/agent-skills-standard

    Generates one integration/E2E test from an approved test case spec using existing project patterns.

    572 GitHub stars~548 tokensUpdated yesterday
    Testing & QAAuto-check passed
  • Flutter MCP E2E Harness

    Arenukvern/mcp_flutter

    A skill your agent uses when writing or running repeatable E2E scenarios for Flutter apps as checked-in Dart with the fluttermcpharness package (packages/harness) — build/launch the app, attach to…

    387 GitHub stars~2.2k tokensUpdated 8 days ago
    MobileAuto-check passed
  • Green Gate

    VeryGoodOpenSource/vgv-ai-flutter-plugin

    Drives a Dart or Flutter package fully green through a verify-fix-rerun loop across four gates: analyze, format, test, coverage.

    170 GitHub stars~4.7k tokensUpdated 5 days ago
    MobileAuto-check: notes
  • Testing Strategy

    bladeofgod/flutter-ai-harness

    适用:编写或审查 Dart 单测、Flutter Widget 测试、Route 测试、集成测试、Fake 或 Mocktail Mock。不适用:Kotlin/Swift 测试框架,也不替代生产实现。触发词:testWidgets、flutter test、Mocktail、Fake、Get.reset、integrationtest、coverage、flaky。

    116 GitHub stars~268 tokensUpdated 1 mo ago
    MobileAuto-check passed
  • MCP Debugger

    debugmcp/mcp-debugger

    A skill your agent uses when investigating a bug, failing test, or unexpected runtime behavior and the mcp-debugger MCP server is available — drives real step-through debuggers (breakpoints, stack…

    174 GitHub stars~4.2k tokensUpdated today
    DevelopmentAuto-check passed

More from abdulmominsakib/localmind

All 13 skills in this repo
  • Flutter Add Widget Preview

    abdulmominsakib/localmind

    Adds interactive widget previews to the project using the previews.dart system.

    268 GitHub starsUsed in 1 repo~1.6k tokens
    Auto-check passed
  • Flutter Feature Based Architecture

    abdulmominsakib/localmind

    Design, implement, refactor, and review Flutter apps that use feature-based vertical slices, handwritten Dart models/providers, componentized StatelessWidget UI, Riverpod state management, and a…

    268 GitHub stars~2.9k tokensUpdated 2 days ago
    Auto-check passed
  • Flutter Add Widget Test

    abdulmominsakib/localmind

    Implement a component-level test using WidgetTester to verify UI rendering and user interactions (tapping, scrolling, entering text).

    268 GitHub starsUsed in 1 repo~1.6k tokens
    Auto-check passed
  • Architects a Flutter application using the recommended layered approach (UI, Logic, Data).

    268 GitHub starsUsed in 1 repo~1.6k tokens
    Auto-check passed
  • Flutter Build Responsive Layout

    abdulmominsakib/localmind

    Use LayoutBuilder, MediaQuery, or Expanded/Flexible to create a layout that adapts to different screen sizes.

    268 GitHub starsUsed in 1 repo~1.7k tokens
    Auto-check passed
  • Flutter Fix Layout Issues

    abdulmominsakib/localmind

    Fixes Flutter layout errors (overflows, unbounded constraints) using Dart and Flutter MCP tools.

    268 GitHub starsUsed in 1 repo~1.3k tokens
    Auto-check passed

Questions about Flutter Add Integration Test

What does Flutter Add Integration Test do?

Configures Flutter Driver for app interaction and converts MCP actions into permanent integration tests. Flutter Add Integration Test is an agent skill from abdulmominsakib/localmind. Configures Flutter Driver for app interaction and converts MCP actions into permanent integration tests.

When should I use Flutter Add Integration Test?

Flutter Add Integration Test fits situations like: adding integration testing to a project; exploring UI components via MCP; automating user flows with the integrationtest package.

How do I install Flutter Add Integration Test in Claude Code?

Run `npx skills add abdulmominsakib/localmind --skill flutter-add-integration-test -a claude-code`. Or copy the skill folder (.agents/skills/flutter-add-integration-test in abdulmominsakib/localmind) into .claude/skills/flutter-add-integration-test in your project. Claude Code loads it when a task matches its description.

How do I install Flutter Add Integration Test in Codex?

Run `npx skills add abdulmominsakib/localmind --skill flutter-add-integration-test -a codex`. Or copy the skill folder (.agents/skills/flutter-add-integration-test in abdulmominsakib/localmind) into .agents/skills/flutter-add-integration-test in your project. Codex loads it when a task matches its description.

Can I use Flutter Add Integration Test in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add abdulmominsakib/localmind --skill flutter-add-integration-test -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/flutter-add-integration-test, .gemini/skills/flutter-add-integration-test, .github/skills/flutter-add-integration-test and .opencode/skills/flutter-add-integration-test in your project.

What does Flutter Add Integration Test need to run?

Going by SKILL.md and its folder, Flutter Add Integration Test needs the command-line tools its instructions call (flutter).

Does Flutter Add Integration Test access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Flutter Add Integration Test safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Flutter Add Integration Test use?

Flutter Add Integration Test is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Flutter Add Integration Test use?

About 1.8k tokens (SKILL.md is roughly 7.3k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Flutter Add Integration Test?

Skills that share tags, products or a category with Flutter Add Integration Test: Flutter Testing (MADTeacher/mad-agents-skills, 110 stars), Specialist Integration Test Generator (HoangNguyen0403/agent-skills-standard, 572 stars), Flutter MCP E2E Harness (Arenukvern/mcp_flutter, 387 stars) and Green Gate (VeryGoodOpenSource/vgv-ai-flutter-plugin, 170 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Flutter Add Integration Test?

abdulmominsakib (a GitHub user) maintains it in abdulmominsakib/localmind, which has 268 GitHub stars. The repository holds 13 skills in this directory. The repository was last updated on October 8, 2026.

Source: abdulmominsakib/localmind on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.