New: 98,000+ skills indexed from GitHub repos with 100+ stars · every skill safety-checkedBrowse top skillsTop skills
Esc to closeBrowse all skills
Submit a skillBrowse skills
Submit a skillBrowse skills

Agent skill

Flutter MCP CLI Runtime Validation

by Arenukvern in Arenukvern/mcp_flutter

Run Flutter MCP runtime validation from CLI in two steps (launch app, then run validate-runtime), including toolkit-extension gating, screenshot/layout capture, app error collection, optional reload…

MITAuto-check passedMobile

Install Flutter MCP CLI Runtime Validation

skills CLI
$ npx skills add Arenukvern/mcp_flutter --skill flutter-mcp-cli-runtime-validation -a claude-code

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

GitHub CLI
$ gh skill install Arenukvern/mcp_flutter flutter-mcp-cli-runtime-validation --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/Arenukvern/mcp_flutter.git skills-src && mkdir -p .claude/skills && cp -r skills-src/plugin/skills/flutter-mcp-cli-runtime-validation .claude/skills/flutter-mcp-cli-runtime-validation && 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-mcp-cli-runtime-validation
GitHub stars
386
Token cost
~1.3k tokens
SKILL.md length
475 words
Files
1
Skills in repo
23
Repo updated
First seen
Licence
MIT

At a glance

Run Flutter MCP runtime validation from CLI in two steps (launch app, then run validate-runtime), including toolkit-extension gating, screenshot/layout capture, app error collection, optional reload…

  • Works in 2 steps: Launch the Flutter app in debug mode. → Run one CLI command
  • Tasks that involve Cross-platform mobile apps
  • SKILL.md covers Two-Step Flow, What validate-runtime Must Prove, Output Handling and Failure Rules, plus 2 more sections
  • Calls dart

What it does

Flutter MCP CLI Runtime Validation is an agent skill from Arenukvern/mcp_flutter. Run Flutter MCP runtime validation from CLI in two steps (launch app, then run validate-runtime), including toolkit-extension gating, screenshot/layout capture, app error collection, optional reload verification, and retry handling for transient first-connect failures.

Its SKILL.md is about 1.3k 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 Mobile, covering Cross-platform mobile apps and MCP servers. It works with Flutter, Model Context Protocol and macOS. The repository describes itself as: MCP Toolkit for Flutter AI Agent Driven Development (MCP/CLI + custom client side tools) - via closed feedback loop (visual & semantic snapshot) and high client side… The licence is MIT.

When your agent uses it

  • Tasks that involve Cross-platform mobile apps
  • Tasks that involve MCP servers

Example prompts

  • “/flutter-mcp-cli-runtime-validation”

Workflow steps

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

  1. Launch the Flutter app in debug mode.
  2. Run one CLI command

What it can do on your machine

Read from SKILL.md and the folder at commit 62f3ee1. 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:

    • dart

    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 MCP CLI Runtime Validation loads about 1.3k tokens when it runs. Until then it costs about 76 tokens; SKILL.md has 475 words of instructions outside code blocks.

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

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 Arenukvern/mcp_flutter at commit 62f3ee1, republished under its MIT licence (© Arenukvern). 475 words, ~1,259 tokens.

Download SKILL.mdSave it as .claude/skills/flutter-mcp-cli-runtime-validation/SKILL.md (or your agent's skills folder).
name
flutter-mcp-cli-runtime-validation
description
Run Flutter MCP runtime validation from CLI in two steps (launch app, then run validate-runtime), including toolkit-extension gating, screenshot/layout capture, app error collection, optional reload verification, and retry handling for transient first-connect failures.
<!-- @FMT_MODE_PRELUDE -->

Flutter MCP CLI Runtime Validation

Use this skill when you need agent-style runtime validation through flutter-mcp-toolkit with minimal operator steps.

Two-Step Flow

  1. Launch the Flutter app in debug mode.
  2. Run one CLI command:
bash
dart run mcp_server_dart/bin/flutter_mcp_toolkit.dart --save-images --output-dir .flutter_mcp/runtime_validation validate-runtime \
  --target ws://127.0.0.1:8181/<token>/ws \
  --timeout-ms 10000 \
  --post-reload-delay-ms 500 \
  --after-reload

Optional skill install in the same command:

bash
dart run mcp_server_dart/bin/flutter_mcp_toolkit.dart validate-runtime \
  --target ws://127.0.0.1:8181/<token>/ws \
  --install-skill

Permission behavior for this flow:

  • validate-runtime stays read/write only for visual capture and defaults to auto_request_once.
  • doctor remains read-only.
  • On macOS, Screen Recording permission belongs to the host process running flutter-mcp-toolkit.
  • On web: desktop_window uses macOS ScreenCaptureKit then Chrome CDP (Page.captureScreenshot); Linux/Windows use CDP when remote debugging is reachable. Pass --web-browser-debugging-port if discovery fails. For web targets, pass --flutter-device chrome so validation does not pick macOS host desktop_window by mistake.
  • Executor recovery retries host capture once (desktopCaptureRetried in screenshot payloads). If desktop_window still fails (including when platform views are detected), validate-runtime retries once with flutter_layer. Check data.summary.captureFallbackUsed.
  • You may pass the VM URI as global --vm-service-uri instead of validate-runtime --target when only one URI is needed.

What validate-runtime Must Prove

  • Doctor preflight passes critical checks.
  • Required toolkit extensions exist:
    • ext.mcp.toolkit.app_errors
    • ext.mcp.toolkit.view_details
    • ext.mcp.toolkit.view_screenshots
    • ext.mcp.toolkit.inspect_widget_at_point
  • Screenshot capture works.
  • View details (layout metadata) are available.
  • App errors are retrievable.
  • If --after-reload is enabled, post-reload screenshot also works.

Output Handling

  • Use data.summary as pass/fail status for automation.
  • Use data.summary.capturePlatformViewsDetected and captureFocusAttempted for platform-view routing.
  • Use data.summary.captureFallbackUsed to see whether a flutter_layer retry ran after a failed desktop_window attempt (including when platform views are detected).
  • Use data.steps for per-step evidence and retries.
  • Use data.doctor.checks to explain setup blockers.
  • Use data.summary.screenshotFiles for saved screenshot paths when --save-images is enabled.
  • When --save-images is enabled, read screenshot file URLs from step data.
  • For visual debugging reports, also run:
    • exec --name capture_ui_snapshot --args '{"errorsCount":4,"compress":true,"includeViewDetails":true,"includeErrors":true}'
    • exec --name inspect_widget_at_point --args '{"x":<int>,"y":<int>}'
Show full SKILL.md (193 more words)Show less

Failure Rules

  • If toolkit extensions are missing, stop and report instrumentation gap with exact fix:
    • add mcp_toolkit to app dependencies
    • ensure MCPToolkitBinding.instance.bootstrapFlutter(...) or equivalent manual initialization runs before runApp
    • hot restart or rerun the app
  • If first explicit URI connect fails, retry is automatic for retryable connection errors.
  • If screenshots are blank, verify app window is visible and retry.
  • If macOS visual capture is denied, use:
    • dart run mcp_server_dart/bin/flutter_mcp_toolkit.dart permissions status
    • dart run mcp_server_dart/bin/flutter_mcp_toolkit.dart permissions request
    • dart run mcp_server_dart/bin/flutter_mcp_toolkit.dart permissions open-settings
  • If app cannot be instrumented, do not claim screenshot/layout/error inspection success.

Visual QA + Source Mapping Rules

  • Always compare before/after screenshot evidence around changes.
  • For each reported visual issue, provide coordinate + inspect_widget_at_point output.
  • Map defects to source using get_app_errors top stack frame (file, line, column) when available.
  • Do not use debug_dump_* unless explicitly requested.

Challenge Cases (Always Call Out Explicitly)

  • No running debug app: doctor critical failure on vm_target_reachable; request app launch before continuing.
  • Wrong target URI/token: treat as connection mismatch and retry with exact app.debugPort.wsUri.
  • Toolkit added but still missing extensions: hot reload is often insufficient, require hot restart/full rerun.
  • Non-modifiable app (cannot add toolkit): report inspection as unavailable instead of guessing.

© Arenukvern, 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 plugin/skills/flutter-mcp-cli-runtime-validation of Arenukvern/mcp_flutter.

Open the folder on GitHubat commit 62f3ee1

Compare with similar skills

Flutter MCP CLI Runtime Validation 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 MCP CLI Runtime Validation compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Flutter MCP CLI Runtime Validation this skillArenukvern/mcp_flutter386—~1.3kAutomated safety check: PassMIT
Native Desktop UI TestingFNOSP/FlyNarwhal495—~2.4kAutomated safety check: PassAGPL-3.0
Retrieving Developer Knowledgegoogle/skills21k—~2kAutomated safety check: PassApache-2.0
MCP Dart Clientleehack/mcp_dart116—~1.8kAutomated safety check: PassMIT
Engine Whats Newflutter/flutter179k—~978Automated safety check: PassBSD-3-Clause
Appllama UsageAppllama/appllama-skills2.5k1 repos~1.6kAutomated safety check: PassMIT

Similar skills

  • Native Desktop UI Testing

    FNOSP/FlyNarwhal

    Run and verify Flutter desktop behavior on Windows/macOS/Linux native clients.

    495 GitHub stars~2.4k tokensUpdated yesterday
    MobileAuto-check passed

  • Retrieving Developer Knowledge

    google/skills

    Official

    Searches, retrieves, and synthesizes official Google developer documentation across Google Cloud, AI/Gemini, Android, Chrome, Web, Flutter, Go, Firebase, and other Google developer platforms.

    21k GitHub stars~2k tokensUpdated today
    Backend & APIsAuto-check passed

  • MCP Dart Client

    leehack/mcp_dart

    A skill your agent uses when connecting a Dart or Flutter app to a Model Context Protocol (MCP) server with mcpdart: creating an McpClient, launching a local server over stdio or reaching a remote…

    116 GitHub stars~1.8k tokensUpdated 2 days ago
    Agent WorkflowsAuto-check passed

  • Engine Whats New

    flutter/flutter

    Generates the "what's new" release summary and diff file for changes in the Flutter engine (//engine/src/flutter) between two releases (e.g., 3.47 vs 3.44).

    179k GitHub stars~978 tokensUpdated today
    MobileAuto-check passed

  • Appllama Usage

    Appllama/appllama-skills

    Use the Appllama MCP (mcp.appllama.io) well — research real top-grossing mobile apps, their screens, flows, and UI elements, then build from what you learn.

    2.5k GitHub starsUsed in 1 repo~1.6k tokens
    MobileAuto-check passed

  • Apple Design

    vrcm-team/VRCM

    Cross-platform UI/UX design reviewer grounded in Apple's Human Interface Guidelines (122 pages pulled from developer.apple.com, including 57 component pages) plus a design-craft lens for…

    179 GitHub starsUsed in 1 repo~6.2k tokens
    MobileAuto-check passed

More from Arenukvern/mcp_flutter

All 23 skills in this repo

  • Harness Engineering Lifecycle

    Arenukvern/mcp_flutter

    Design, implement, and integrate generalized validation harnesses across a producer-consumer boundary after a local harness contract exists.

    386 GitHub stars~1.6k tokensUpdated 4 days ago
    Auto-check passed

  • Mixture Of Experts

    Arenukvern/mcp_flutter

    Run a Mixture of Experts (MoE) audit on any topic, plan, codebase, evidence archive, or process.

    386 GitHub stars~2.3k tokensUpdated 4 days ago
    Auto-check passed

  • Multi Agent Handoff

    Arenukvern/mcp_flutter

    Plan and document handoffs, parent lane contracts, and parallel batch contracts between specialized AI agents (foreman, workers, reviewers).

    386 GitHub stars~2.7k tokensUpdated 4 days ago
    Auto-check passed

  • Plugin Marketplace Setup

    Arenukvern/mcp_flutter

    Designs public or private Agent Skill and plugin marketplaces for Cursor, Claude Code, Codex, Zed, Open Plugin, and npx skills—manifest layout, install matrix, and Skill Steward vs product boundaries.

    386 GitHub stars~2.9k tokensUpdated 4 days ago
    Auto-check passed

  • Release Changelog Harness

    Arenukvern/mcp_flutter

    Chooses ecosystem-native release and changelog tooling (Changesets, Melos, release-plz) plus binary distribution (GitHub Release tarballs, install.sh) when the product is an executable.

    386 GitHub stars~2.6k tokensUpdated 4 days ago
    Auto-check passed

  • Repository Governance Lifecycle

    Arenukvern/mcp_flutter

    Master orchestration for repository governance, North Star impact, sub-Star boundaries, and repair-first or evidence-first drift checks.

    386 GitHub stars~1.5k tokensUpdated 4 days ago
    Auto-check passed

Works with

Categories

Questions about Flutter MCP CLI Runtime Validation

What does Flutter MCP CLI Runtime Validation do?

Run Flutter MCP runtime validation from CLI in two steps (launch app, then run validate-runtime), including toolkit-extension gating, screenshot/layout capture, app error collection, optional reload…. Flutter MCP CLI Runtime Validation is an agent skill from Arenukvern/mcp_flutter. Run Flutter MCP runtime validation from CLI in two steps (launch app, then run validate-runtime), including toolkit-extension gating, screenshot/layout capture, app error collection, optional reload verification, and retry handling for transient first-connect failures.

When should I use Flutter MCP CLI Runtime Validation?

Flutter MCP CLI Runtime Validation fits situations like: tasks that involve Cross-platform mobile apps; tasks that involve MCP servers.

How do I install Flutter MCP CLI Runtime Validation in Claude Code?

Run `npx skills add Arenukvern/mcp_flutter --skill flutter-mcp-cli-runtime-validation -a claude-code`. Or copy the skill folder (plugin/skills/flutter-mcp-cli-runtime-validation in Arenukvern/mcp_flutter) into .claude/skills/flutter-mcp-cli-runtime-validation in your project. Claude Code loads it when a task matches its description.

How do I install Flutter MCP CLI Runtime Validation in Codex?

Run `npx skills add Arenukvern/mcp_flutter --skill flutter-mcp-cli-runtime-validation -a codex`. Or copy the skill folder (plugin/skills/flutter-mcp-cli-runtime-validation in Arenukvern/mcp_flutter) into .agents/skills/flutter-mcp-cli-runtime-validation in your project. Codex loads it when a task matches its description.

Can I use Flutter MCP CLI Runtime Validation 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 Arenukvern/mcp_flutter --skill flutter-mcp-cli-runtime-validation -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-mcp-cli-runtime-validation, .gemini/skills/flutter-mcp-cli-runtime-validation, .github/skills/flutter-mcp-cli-runtime-validation and .opencode/skills/flutter-mcp-cli-runtime-validation in your project.

What does Flutter MCP CLI Runtime Validation need to run?

Going by SKILL.md and its folder, Flutter MCP CLI Runtime Validation needs the command-line tools its instructions call (dart).

Does Flutter MCP CLI Runtime Validation 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 MCP CLI Runtime Validation 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 MCP CLI Runtime Validation use?

Flutter MCP CLI Runtime Validation 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 MCP CLI Runtime Validation use?

About 1.3k tokens (SKILL.md is roughly 5k 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 MCP CLI Runtime Validation?

Skills that share tags, products or a category with Flutter MCP CLI Runtime Validation: Native Desktop UI Testing (FNOSP/FlyNarwhal, 495 stars), Retrieving Developer Knowledge (google/skills, 21k stars), MCP Dart Client (leehack/mcp_dart, 116 stars) and Engine Whats New (flutter/flutter, 179k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Flutter MCP CLI Runtime Validation?

Arenukvern (a GitHub user) maintains it in Arenukvern/mcp_flutter, which has 386 GitHub stars. The repository holds 23 skills in this directory. The repository was last updated on October 3, 2026.

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