Add flutter-app-runtime skill for runtime inspection MCP tools - #230
Open
jwren wants to merge 1 commit into
Open
Add flutter-app-runtime skill for runtime inspection MCP tools#230jwren wants to merge 1 commit into
jwren wants to merge 1 commit into
Conversation
Contributor
There was a problem hiding this comment.
Code Review
This pull request introduces a new skill, flutter-app-runtime, which enables interaction with running Dart and Flutter applications using Dart MCP server tools. The changes include adding the skill to the README, defining its configuration in flutter_skills.yaml, and creating a comprehensive guide in SKILL.md. The feedback recommends adding a trailing newline to the end of flutter_skills.yaml to ensure POSIX compatibility.
| resources: | ||
| - https://docs.flutter.dev/ai/mcp-server | ||
| - https://docs.flutter.dev/ai/get-started | ||
| - https://docs.flutter.dev/tools/hot-reload No newline at end of file |
Contributor
jwren
force-pushed
the
skill-flutter-app-runtime
branch
from
August 31, 2026 23:44
03b4e18 to
fe246ac
Compare
This was referenced Sep 1, 2026
Add the `flutter-app-runtime` skill to provide runtime application discovery, live widget inspection, layout/error diagnostics, and proactive hot reloading via the Dart MCP server. This skill provides the runtime management workflows referenced by the proactive Flutter hot reload rule introduced in flutter#228 (rules/flutter-app-runtime.md). While the rule triggers upon `.dart` file modifications, this skill also equips agents to handle non-edit observational queries about the running application without falling back to static source code assumptions. Key capabilities and workflows added: - Live UI & Hierarchy Inspection: Query the live widget tree via `widget_inspector` (`get_widget_tree`), supporting `summaryOnly: false` to inspect exact immediate parent widgets and framework styling wrappers, and `summaryOnly: true` for user code structure. - Layout Overflow & Error Diagnostics: Check for active `RenderFlex` overflows and framework exceptions using `get_runtime_errors` and inspect render box constraints. - Proactive Hot Reload / Hot Restart: Execute `hot_reload` on UI modifications or `hot_restart` on foundational state/initialization changes, followed by verifying runtime stability. - Application Discovery: Discover and connect to active instances via `dtd` (`listDtdUris`, `connect`, `listConnectedApps`) with clear fallback handling when no running app is connected. Related: - Companion rule: flutter#228 - Supersedes: flutter#221
jwren
force-pushed
the
skill-flutter-app-runtime
branch
from
September 1, 2026 18:08
fe246ac to
34d5533
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
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.
Add the
flutter-app-runtimeskill to provide runtime application discovery,live widget inspection, layout/error diagnostics, and proactive hot reloading
via the Dart MCP server.
This skill provides the runtime management workflows referenced by the proactive
Flutter hot reload rule introduced in #228 (rules/flutter-app-runtime.md). While
the rule triggers upon
.dartfile modifications, this skill also equips agentsto handle non-edit observational queries about the running application without
falling back to static source code assumptions.
Key capabilities and workflows added:
widget_inspector(
get_widget_tree), supportingsummaryOnly: falseto inspect exact immediateparent widgets and framework styling wrappers, and
summaryOnly: truefor usercode structure.
RenderFlexoverflows andframework exceptions using
get_runtime_errorsand inspect render box constraints.hot_reloadon UI modifications orhot_restarton foundational state/initialization changes, followed byverifying runtime stability.
dtd(
listDtdUris,connect,listConnectedApps) with clear fallback handlingwhen no running app is connected.
Related: