Agent skill

Flutter Debug Runtime

by bladeofgod in bladeofgod/flutter-ai-harness

适用:在 App Operator 或 Marionette 验证前,为 Android/iOS 构建、安装并启动 Flutter Debug App,获取 VM Service URI。不适用:Release 构建、签名配置、系统权限自动化、账号登录或测试数据准备。触发词:flutter run、Debug App、设备安装、VM Service URI、App Operator 前置环境。

MITAuto-check passedMobile

Install Flutter Debug Runtime

skills CLI
$ npx skills add bladeofgod/flutter-ai-harness --skill flutter-debug-runtime -a claude-code

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

GitHub CLI
$ gh skill install bladeofgod/flutter-ai-harness flutter-debug-runtime --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/bladeofgod/flutter-ai-harness.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/flutter-debug-runtime .claude/skills/flutter-debug-runtime && 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-debug-runtime
GitHub stars
116
Token cost
~274 tokens
SKILL.md length
57 words
Files
1
Skills in repo
11
Repo updated
First seen
Licence
MIT

At a glance

适用:在 App Operator 或 Marionette 验证前,为 Android/iOS 构建、安装并启动 Flutter Debug App,获取 VM Service URI。不适用:Release 构建、签名配置、系统权限自动化、账号登录或测试数据准备。触发词:flutter run、Debug App、设备安装、VM Service URI、App Operator 前置环境。

  • Works in 6 steps: 读取 Spec,并只处理用户在 /execute-ui-spec… → 运行 bash scripts/flutter-tool.sh… → 依赖发生变化时先运行 bash scripts/dart-tool.sh pub… → …
  • Tasks that involve Cross-platform mobile apps
  • Calls bash

What it does

Flutter Debug Runtime is an agent skill from bladeofgod/flutter-ai-harness. 适用:在 App Operator 或 Marionette 验证前,为 Android/iOS 构建、安装并启动 Flutter Debug App,获取 VM Service URI。不适用:Release 构建、签名配置、系统权限自动化、账号登录或测试数据准备。触发词:flutter run、Debug App、设备安装、VM Service URI、App Operator 前置环境。

Its SKILL.md is about 270 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. It works with Flutter, Android and iOS. The repository describes itself as: An AI-native engineering harness for production Flutter and hybrid mobile app repositories. The licence is MIT.

When your agent uses it

  • Tasks that involve Cross-platform mobile apps

Example prompts

  • “/flutter-debug-runtime”

Workflow steps

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

  1. 读取 Spec,并只处理用户在 /execute-ui-spec 中明确选择的当前平台;不得自动扩展到 Spec 的其他声明平台。
  2. 运行 bash scripts/flutter-tool.sh devices,选择用户指定设备;存在多个候选且用户未指定时请求选择。
  3. 依赖发生变化时先运行 bash scripts/dart-tool.sh pub get。
  4. 使用以下入口构建、安装并保持 Debug App 运行
  5. 从输出中取得 ws://.../ws VM Service URI,只在当前调用中交给 Operator,不写入仓库产物。
  6. 确认 App 启动且 Marionette Binding 可连接后,将目标平台、非敏感 OS 版本、设备类型和 VM Service URI 仅在当前调用中交接给 Operator。

What it can do on your machine

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

    • bash

    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 Debug Runtime loads about 274 tokens when it runs. Until then it costs about 55 tokens; SKILL.md has 57 words of instructions outside code blocks.

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

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 bladeofgod/flutter-ai-harness at commit 9f1a1ca, republished under its MIT licence (© bladeofgod). 57 words, ~274 tokens.

Download SKILL.mdSave it as .claude/skills/flutter-debug-runtime/SKILL.md (or your agent's skills folder).
name
flutter-debug-runtime
description
适用:在 App Operator 或 Marionette 验证前,为 Android/iOS 构建、安装并启动 Flutter Debug App,获取 VM Service URI。不适用:Release 构建、签名配置、系统权限自动化、账号登录或测试数据准备。触发词:flutter run、Debug App、设备安装、VM Service URI、App Operator 前置环境。
paths
app/apps/**/lib/main.dart, app/apps/**/android/**, app/apps/**/ios/**, .claude/commands/execute-ui-spec.md, .mcp.json, scripts/flutter-tool.sh

Flutter Debug Runtime

为运行态 UI 验证准备 App;完成交接后由 app-operator 专注执行 Spec。

流程

  1. 读取 Spec,并只处理用户在 /execute-ui-spec 中明确选择的当前平台;不得自动扩展到 Spec 的其他声明平台。

  2. 运行 bash scripts/flutter-tool.sh devices,选择用户指定设备;存在多个候选且用户未指定时请求选择。

  3. 依赖发生变化时先运行 bash scripts/dart-tool.sh pub get。

  4. 使用以下入口构建、安装并保持 Debug App 运行:

    bash
    TOOL_WORKDIR=app/apps/demo bash scripts/flutter-tool.sh run --debug -d <device-id>
  5. 从输出中取得 ws://.../ws VM Service URI,只在当前调用中交给 Operator,不写入仓库产物。

  6. 确认 App 启动且 Marionette Binding 可连接后,将目标平台、非敏感 OS 版本、设备类型和 VM Service URI 仅在当前调用中交接给 Operator。

不得修改签名、Development Team、应用标识或发布配置。设备不可用、系统权限弹窗阻塞、账号/测试数据缺失或平台工具链需要人工处理时,准确说明阻塞并请求介入,不用伪造状态或产品行为绕过。

© bladeofgod, 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 .claude/skills/flutter-debug-runtime of bladeofgod/flutter-ai-harness.

Open the folder on GitHubat commit 9f1a1ca

Compare with similar skills

Flutter Debug Runtime 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 Debug Runtime compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Flutter Debug Runtime this skillbladeofgod/flutter-ai-harness116—~274Automated safety check: PassMIT
Engine Whats Newflutter/flutter179k—~978Automated safety check: PassBSD-3-Clause
SimdeckNativeScript/SimDeck152—~3.6kAutomated safety check: PassMIT
Detour Onboardingsoftware-mansion-labs/skills291—~2.8kAutomated safety check: PassNone
flutter_soloud Setupalnitak/flutter_soloud424—~3.6kAutomated safety check: NotesMIT
AI App Bridge UsemobileAiDev/ai-app-bridge227—~1.4kAutomated safety check: PassApache-2.0

Similar skills

  • 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
  • Simdeck

    NativeScript/SimDeck

    A skill your agent uses for simulator lifecycle, app install/launch, live viewing, UI inspection, touch/keyboard automation, screenshots, recordings, logs, pasteboard, hardware controls, and…

    152 GitHub stars~3.6k tokensUpdated 26 days ago
    MobileAuto-check passed
  • Detour Onboarding

    software-mansion-labs/skills

    Complete onboarding guide for developers who are new to Detour, the open-source deferred deep linking SDK by Software Mansion.

    291 GitHub stars~2.8k tokensUpdated 10 days ago
    MobileAuto-check passed
  • flutter_soloud Setup

    alnitak/flutter_soloud

    Walks through adding the flutter_soloud audio engine to a Flutter app, with per-platform setup, initialization, binary-size and logging options, and output device switching.

    424 GitHub stars~3.6k tokensUpdated yesterday
    MobileAuto-check: notes
  • AI App Bridge Use

    mobileAiDev/ai-app-bridge

    使用 AI App Bridge 观察、操作和验证 Android、iOS、Flutter、WebView 或 Web App;适用于真实交互、流程自动化和设备诊断。

    227 GitHub stars~1.4k tokensUpdated yesterday
    MobileAuto-check passed
  • Flutter App

    ccplugins/awesome-claude-code-plugins

    Bootstrap a new Flutter mobile app with clean architecture, Riverpod, FVM-pinned SDK, current packages, and no deprecated APIs.

    968 GitHub stars~1.1k tokensUpdated 1 mo ago
    MobileAuto-check: notes

More from bladeofgod/flutter-ai-harness

All 11 skills in this repo
  • Getx Patterns

    bladeofgod/flutter-ai-harness

    适用:代码使用 GetxController、GetxService、Rx、Obx、GetBuilder、Get.find、Bindings 或 Worker。不适用:GetX 路由、Dialog、Snackbar,或 Controller 内隐式查找 API。触发词:GetX、Obx、.obs、Rx、Get.find、GetxService、Worker、Binding。

    116 GitHub stars~462 tokensUpdated 1 mo ago
    Auto-check passed
  • UI Behavior Spec

    bladeofgod/flutter-ai-harness

    适用:根据已批准任务、产品规则、原型或 Figma 输入生成、审计或执行 Version 1 UI 行为 Spec。不适用:替代产品决策、实现 UI、操作系统原生界面或探索未定义流程。触发词:UI Spec、行为契约、plan-spec、spec-writer、spec-auditor、app-operator、Marionette 验收。

    116 GitHub stars~1.4k tokensUpdated 1 mo ago
    Auto-check passed
  • Dart Coding Standards

    bladeofgod/flutter-ai-harness

    适用:编写或审查 Dart/Flutter 生产代码,尤其是 Controller、Service、Stream、异步任务和依赖注入。不适用:Kotlin、Swift 或生成代码规范。触发词:Dart、Controller、Service、StreamSubscription、unawaited、dynamic、DI、重构。

    116 GitHub stars~228 tokensUpdated 1 mo ago
    Auto-check passed
  • Figma To Flutter

    bladeofgod/flutter-ai-harness

    适用:读取 Figma 或根据节点实现 Flutter UI,包括 Token 反查、Auto Layout、组件 Variant、Asset 和视觉验证。不适用:替代产品决策,或从像素推断设计稿不可见的数据行为。触发词:Figma URL、node-id、design-to-code、视觉还原、Auto Layout、design token。

    116 GitHub stars~270 tokensUpdated 1 mo ago
    Auto-check passed
  • Go Router

    bladeofgod/flutter-ai-harness

    适用:新增 Route、Redirect、ShellRoute/StatefulShellRoute、DeepLink、路由参数、Observer 或 Route 级 Controller 装配。不适用:GetX 导航或没有明确兼容边界的任意 Navigator Stack。触发词:GoRouter、GoRoute、redirect、deep link、shell…

    116 GitHub stars~295 tokensUpdated 1 mo ago
    Auto-check passed
  • Kotlin Android Standards

    bladeofgod/flutter-ai-harness

    适用:编写或审查 Android Kotlin Native Module、Bridge Adapter、Host 接线、Manifest、Gradle 和原生 UI。不适用:Swift/iOS、Dart Client 或 Wire Contract 设计。触发词:Kotlin、Android、Gradle、Manifest、Coroutine、Flow、CameraX、Activity。

    116 GitHub stars~352 tokensUpdated 1 mo ago
    Auto-check passed

Categories

Questions about Flutter Debug Runtime

What does Flutter Debug Runtime do?

适用:在 App Operator 或 Marionette 验证前,为 Android/iOS 构建、安装并启动 Flutter Debug App,获取 VM Service URI。不适用:Release 构建、签名配置、系统权限自动化、账号登录或测试数据准备。触发词:flutter run、Debug App、设备安装、VM Service URI、App Operator 前置环境。. Flutter Debug Runtime is an agent skill from bladeofgod/flutter-ai-harness.

When should I use Flutter Debug Runtime?

Flutter Debug Runtime fits situations like: tasks that involve Cross-platform mobile apps.

How do I install Flutter Debug Runtime in Claude Code?

Run `npx skills add bladeofgod/flutter-ai-harness --skill flutter-debug-runtime -a claude-code`. Or copy the skill folder (.claude/skills/flutter-debug-runtime in bladeofgod/flutter-ai-harness) into .claude/skills/flutter-debug-runtime in your project. Claude Code loads it when a task matches its description.

How do I install Flutter Debug Runtime in Codex?

Run `npx skills add bladeofgod/flutter-ai-harness --skill flutter-debug-runtime -a codex`. Or copy the skill folder (.claude/skills/flutter-debug-runtime in bladeofgod/flutter-ai-harness) into .agents/skills/flutter-debug-runtime in your project. Codex loads it when a task matches its description.

Can I use Flutter Debug Runtime 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 bladeofgod/flutter-ai-harness --skill flutter-debug-runtime -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-debug-runtime, .gemini/skills/flutter-debug-runtime, .github/skills/flutter-debug-runtime and .opencode/skills/flutter-debug-runtime in your project.

What does Flutter Debug Runtime need to run?

Going by SKILL.md and its folder, Flutter Debug Runtime needs the command-line tools its instructions call (bash).

Does Flutter Debug Runtime 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 Debug Runtime 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 Debug Runtime use?

Flutter Debug Runtime 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 Debug Runtime use?

About 274 tokens (SKILL.md is roughly 1.1k 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 Debug Runtime?

Skills that share tags, products or a category with Flutter Debug Runtime: Engine Whats New (flutter/flutter, 179k stars), Simdeck (NativeScript/SimDeck, 152 stars), Detour Onboarding (software-mansion-labs/skills, 291 stars) and flutter_soloud Setup (alnitak/flutter_soloud, 424 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Flutter Debug Runtime?

bladeofgod (a GitHub user) maintains it in bladeofgod/flutter-ai-harness, which has 116 GitHub stars. The repository holds 11 skills in this directory. The repository was last updated on September 7, 2026.

Source: bladeofgod/flutter-ai-harness on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.