flutter-mcp-toolkit-guide
- Repo stars 0
- Author updated Live
- Author repo skills-registry
- Domain
- AI
- Compatible agents
-
- Claude Code
- Cursor
- Cline
- Codex
- Windsurf
- Gemini CLI
- +20
- Trust score
- 88 / 100 · community maintained
- Author / version / license
- @tomevault-io · no license declared
- Token usage
- Lean
- Setup complexity
- Guided setup
- External API key
- Not required
- Operating systems
- Unspecified (assume cross-platform)
- Runtime requirements
- No special requirements
- Permissions
-
- Read-only
- Shell exec
- Write / modify
- Network behavior
- Local-only
- Install commands
- 26 variants
Profile is derived at build time from SKILL.md and install vectors. Subject to drift from author intent.
Heads up: 未限定 allowed-tools,默认拥有全部工具权限。
---
name: flutter-mcp-toolkit-guide
description: Entry point for inspecting or driving a running Flutter app from your AI assistant — routes to t…
category: ai
runtime: no special runtime
---
# flutter-mcp-toolkit-guide output preview
## PART A: Task fit
- Use case: Entry point for inspecting or driving a running Flutter app from your AI assistant — routes to the right task skill (inspect / control / debug / custom app surfaces) and runs preflight. Use when this capability is needed..
- Inputs: target material, constraints, expected output, and acceptance criteria.
- Evidence boundary: follow “When to use / Step 1: Preflight / Step 2: Pick the right skill for the user's intent” and do not present inference as author intent.
## PART B: Execution result
- **01** The card summarizes the use case; runtime output centers on “Entry point for inspecting or driving a running Flutter app from your AI assistant — routes to the right task skill (inspect / control / debug / custom app surfaces) and runs preflight. Use when this capability is needed.”.
- **02** When the source has headings, the agent prioritizes “When to use / Step 1: Preflight / Step 2: Pick the right skill for the user's intent” so the result follows the author’s structure.
- **03** Typical output includes task judgment, concrete steps, required commands or file edits, validation, and follow-up options.
- **04** Risk context follows the fingerprint: read files, run shell commands, write/modify files; mostly runs locally; usually needs no extra API key.
## Running Rules
- read files, run shell commands, write/modify files; mostly runs locally; usually needs no extra API key.
- Validate with a small sample before expanding scope.
- Return the result, validation criteria, and next iteration options. The source does not require a stable slash command. After installation, invoke the skill by name and describe the task.
Name target files or source material, expected output, forbidden changes, and whether network or shell access is allowed. Permission fingerprint: read files, run shell commands, write/modify files.
Start with a small task and check whether the result follows “When to use / Step 1: Preflight / Step 2: Pick the right skill for the user's intent”. Inspect diffs, logs, previews, or tests before expanding scope.
Confirm the final output includes a concrete result, evidence, and next action. If it stays generic, tighten inputs, boundaries, and acceptance criteria.
---
name: flutter-mcp-toolkit-guide
description: Entry point for inspecting or driving a running Flutter app from your AI assistant — routes to t…
category: ai
source: tomevault-io/skills-registry
---
# flutter-mcp-toolkit-guide
## When to use
- Entry point for inspecting or driving a running Flutter app from your AI assistant — routes to the right task skill (i…
- Use it when the task has clear inputs, repeatable steps, and validation criteria.
## What to provide
- Target material, scope, expected result, and forbidden changes.
- Whether network, commands, file writes, or external services are allowed.
## Execution rules
- Organize steps around “When to use / Step 1: Preflight / Step 2: Pick the right skill for the user's intent” and keep inference separate from source facts.
- read files, run shell commands, write/modify files; mostly runs locally; usually needs no extra API key.
- Validate with a small sample before expanding the task.
## Output requirements
- Return the deliverable, key evidence, validation method, and next action.
- Mark missing information as unknown; do not invent commands, platforms, or dependencies. The author source anchors workflow facts; repository files anchor sources and commands; Fluxly only adds fit, limitations, and quality judgment.
skill "flutter-mcp-toolkit-guide" {
input -> user goal + target files + boundaries + acceptance criteria
context -> When to use / Step 1: Preflight / Step 2: Pick the right skill for the user's intent
rules -> SKILL.md triggers / order / output contract
runtime -> no special runtime | read files, run shell commands, write/modify files | mostly runs locally
guardrails -> usually needs no extra API key + small-sample validation + diff/log review
output -> copyable result + checklist + next iteration
} When to use
Use this skill when the user wants to inspect or drive a running Flutter app from this conversation. Examples:
- "Tap the login button in my app"
- "Why is the home screen blank?"
- "Take a screenshot and tell me what's broken"
- "Expose my cart / flags / internal state to the agent via MCP"
If the user is asking about Flutter concepts unrelated to a running app (architecture questions, package selection), this skill does not apply.
Step 1: Preflight
Always run flutter-mcp-toolkit doctor --json first. Parse the output:
status: "ok"— proceed to Step 2.status: "error"anderror.code: "binary_not_found"— loadflutter-mcp-toolkit-setupand follow its install instructions.status: "error"anderror.code: "vm_not_connected"— loadflutter-mcp-toolkit-setupand follow its troubleshooting section.- Any other error — load
flutter-mcp-toolkit-debugand read the error envelope playbook.
Step 2: Pick the right skill for the user's intent
| User intent | Load skill |
|---|---|
| Read state ("what's on screen?", "show me errors", "screenshot") | flutter-mcp-toolkit-inspect |
| Drive UI ("tap X", "type into Y", "scroll to Z", "hot reload") | flutter-mcp-toolkit-control |
| Diagnose ("why is X failing?", "show recent logs", "evaluate expression") | flutter-mcp-toolkit-debug |
Register app-specific MCP tools/resources (MCPCallEntry, bootstrapFlutter additionalEntries) |
flutter-mcp-toolkit-custom-tools |
If the task spans more than one (e.g. "tap the button and show me what
changed"), load inspect AND control. Skills are additive.
Step 3: Execute
Each task skill has the tool list, parameter shapes, and example calls. Follow the prelude at the top of the skill — it tells you whether you're calling MCP tools or shelling out to the CLI.
Tool taxonomy reference
The core toolkit tools fall into these categories. The full list with parameter shapes lives in the task skills.
- Inspection (read-only):
discover_debug_apps,get_app_errors,get_screenshots,get_view_details,get_vm,get_extension_rpcs,semantic_snapshot,inspect_widget_at_point,capture_ui_snapshot,connect_debug_app. →flutter-mcp-toolkit-inspect. - Interaction (mutating):
tap_widget,long_press,enter_text,fill_form,scroll,swipe,drag,hover,press_key,wait_for,navigate,handle_dialog,hot_reload_flutter,hot_restart_flutter,hot_reload_and_capture. →flutter-mcp-toolkit-control. - Debug:
get_recent_logs,evaluate_dart_expression. →flutter-mcp-toolkit-debug. - Dynamic registry (app-defined): after registration in the Flutter app,
list with
list_client_tools_and_resources, thenclient_tool/client_resource— wire names asfmt_*when calling MCP. →flutter-mcp-toolkit-custom-tools.
When in doubt
If doctor is green but a tool call fails, read the returned error.code
and error.recovery fields. The full code → recovery table is in
flutter-mcp-toolkit-debug.
Source: Arenukvern/mcp_flutter — distributed by TomeVault.
Decide Fit First
Design Intent
How To Use It
Boundaries And Review