Add flutter-app-runtime Agent Skill for runtime interaction and proactive hot reload - #221
Open
jwren wants to merge 1 commit into
Open
Add flutter-app-runtime Agent Skill for runtime interaction and proactive hot reload#221jwren wants to merge 1 commit into
jwren wants to merge 1 commit into
Conversation
![gemini-code-assist[bot]](https://avatars.githubusercontent.com/in/956858?s=60&v=4){kind=small}
Contributor
There was a problem hiding this comment.
Code Review
This pull request introduces the flutter-app-runtime skill, which enables interaction with running Dart and Flutter applications via the Dart MCP server for features like hot reload, hot restart, widget inspection, and error fetching. The changes add the skill to the README, the main configuration file, and create a detailed markdown guide. The review feedback suggests adding the missing example prompt in both the README and the YAML configuration for consistency, as well as correcting the flutter pub add command syntax in the documentation to use the standard --sdk flag.
| | [flutter-add-integration-test](skills/flutter-add-integration-test/SKILL.md) | 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. | Add an integration test that validates the checkout experience | | ||
| | [flutter-add-widget-preview](skills/flutter-add-widget-preview/SKILL.md) | Adds interactive widget previews to the project using the previews.dart system. Use when creating new UI components or updating existing screens to ensure consistent design and interactive testing. | Create a preview for the ProductCard widget with different price states | | ||
| | [flutter-add-widget-test](skills/flutter-add-widget-test/SKILL.md) | Implement a component-level test using `WidgetTester` to verify UI rendering and user interactions (tapping, scrolling, entering text). Use when validating that a specific widget displays correct data and responds to events as expected. | Add a widget test for the CustomButton to verify the onTap callback is called | | ||
| | [flutter-app-runtime](skills/flutter-app-runtime/SKILL.md) | Interacts with running Dart and Flutter applications via the Dart MCP server to enable hot reload, hot restart, widget inspection, and error fetching. Use when modifying UI widgets, debugging errors, inspecting running apps, or proactively hot reloading whenever changes are made to Flutter UI widgets. | | |
Contributor
There was a problem hiding this comment.
The example prompt column is currently empty for the flutter-app-runtime skill. Please add a representative example prompt to match the other skills in the table.
Suggested change
| | [flutter-app-runtime](skills/flutter-app-runtime/SKILL.md) | Interacts with running Dart and Flutter applications via the Dart MCP server to enable hot reload, hot restart, widget inspection, and error fetching. Use when modifying UI widgets, debugging errors, inspecting running apps, or proactively hot reloading whenever changes are made to Flutter UI widgets. | | | |
| | [flutter-app-runtime](skills/flutter-app-runtime/SKILL.md) | Interacts with running Dart and Flutter applications via the Dart MCP server to enable hot reload, hot restart, widget inspection, and error fetching. Use when modifying UI widgets, debugging errors, inspecting running apps, or proactively hot reloading whenever changes are made to Flutter UI widgets. | Hot reload the running application to show the new button style | |
Comment on lines
+435
to
+440
| - name: flutter-app-runtime | ||
| description: Interacts with running Dart and Flutter applications via the | ||
| Dart MCP server to enable hot reload, hot restart, widget inspection, and | ||
| error fetching. Use when modifying UI widgets, debugging errors, inspecting | ||
| running apps, or proactively hot reloading whenever changes are made to | ||
| Flutter UI widgets. |
Contributor
There was a problem hiding this comment.
The examplePrompt field is missing for the flutter-app-runtime skill. Adding it ensures consistency with other skills and allows automated tools to populate the README correctly.
- name: flutter-app-runtime
description: Interacts with running Dart and Flutter applications via the
Dart MCP server to enable hot reload, hot restart, widget inspection, and
error fetching. Use when modifying UI widgets, debugging errors, inspecting
running apps, or proactively hot reloading whenever changes are made to
Flutter UI widgets.
examplePrompt: "Hot reload the running application to show the new button style"|
|
||
| To drive a running Flutter app (take screenshots, tap buttons, enter text), the app must be instrumented with `flutter_driver`. | ||
|
|
||
| - [ ] 1. Verify `flutter_driver` is in `pubspec.yaml`. If not, run `flutter pub add "flutter_driver:{sdk: flutter}"`. |
Contributor
There was a problem hiding this comment.
The command flutter pub add "flutter_driver:{sdk: flutter}" uses invalid JSON descriptor syntax (keys and values must be double-quoted in JSON, e.g., {"sdk":"flutter"}). To avoid syntax errors and shell quoting issues, it is highly recommended to use the standard --sdk flag instead.
Suggested change
| - [ ] 1. Verify `flutter_driver` is in `pubspec.yaml`. If not, run `flutter pub add "flutter_driver:{sdk: flutter}"`. | |
| - [ ] 1. Verify `flutter_driver` is in `pubspec.yaml`. If not, run `flutter pub add flutter_driver --sdk=flutter`. |
…ot reload - Add the `flutter-app-runtime` skill definition to `resources/flutter_skills.yaml`. - Generate `skills/flutter-app-runtime/SKILL.md` to guide agents in discovering running applications via DTD/MCP, proactively hot reloading on widget changes, and diagnosing runtime errors. - Update `README.md` with the new skill entry.
jwren
force-pushed
the
new-skill-flutter-app-runtime
branch
from
August 17, 2026 22:33
40c35e4 to
bb2d719
Compare
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Adds the
flutter-app-runtimeskill to teach AI agents how to discover running Dart/Flutter applications via the Dart Tooling Daemon (DTD) and Dart MCP server, proactively execute hot reload/restart, and diagnose runtime errors.resources/flutter_skills.yaml): Added theflutter-app-runtimeentry with reference docs and prompt examples.skills/flutter-app-runtime/SKILL.md): Comprehensive procedural workflows for:vm_service.get_runtime_errorsandwidget_inspector.flutter_drivercommands.README.md): Addedflutter-app-runtimeto the Available Skills table.Ref: dart-lang/ai#498
Related: #220