Agent skill

Flutter PR Checks Finder

by flutter in flutter/flutter

Find failing checks on a Flutter PR and locate the corresponding LUCI log URLs.

BSD-3-ClauseAuto-check passedMobile

Install Flutter PR Checks Finder

skills CLI
$ npx skills add flutter/flutter --skill flutter-pr-checks-finder -a claude-code

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

GitHub CLI
$ gh skill install flutter/flutter flutter-pr-checks-finder --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/flutter/flutter.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/flutter-pr-checks-finder .claude/skills/flutter-pr-checks-finder && 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-pr-checks-finder
GitHub stars
179k
Token cost
~1.3k tokens
SKILL.md length
663 words
Files
1
Skills in repo
14
Repo updated
First seen
Licence
BSD-3-Clause

At a glance

Find failing checks on a Flutter PR and locate the corresponding LUCI log URLs.

  • Works in 2 steps: Find Failing Checks → Retrieve Failure Logs
  • Tasks that involve Cross-platform mobile apps
  • SKILL.md covers Prerequisites and Workflow
  • Calls gh; reaches api.github.com and ci.chromium.org

What it does

Flutter PR Checks Finder is an agent skill from flutter/flutter. Find failing checks on a Flutter PR and locate the corresponding LUCI log URLs.

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. It works with Flutter, GitHub, macOS and Dart. The repository describes itself as: Flutter makes it easy and fast to build beautiful apps for mobile and beyond. The licence is BSD-3-Clause.

When your agent uses it

  • Tasks that involve Cross-platform mobile apps

Example prompts

  • “/flutter-pr-checks-finder”

Workflow steps

2 steps, taken from the step headings in SKILL.md.

  1. Find Failing Checks
  2. Retrieve Failure Logs

What it can do on your machine

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

    • gh

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • api.github.com
    • ci.chromium.org
    • logs.chromium.org

    Also links to:

    • github.com

    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 PR Checks Finder loads about 1.3k tokens when it runs. Until then it costs about 26 tokens; SKILL.md has 663 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~26
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 flutter/flutter at commit 8679894, republished under its BSD-3-Clause licence (© flutter). 663 words, ~1,315 tokens.

Download SKILL.mdSave it as .claude/skills/flutter-pr-checks-finder/SKILL.md (or your agent's skills folder).
name
flutter-pr-checks-finder
description
Find failing checks on a Flutter PR and locate the corresponding LUCI log URLs.

Flutter PR Checks Finder

Prerequisites

  • gh (GitHub CLI) must be installed and authenticated. If not in your PATH, check common locations like /opt/homebrew/bin/gh on macOS or C:\Program Files\GitHub CLI\gh.exe on Windows.
  • Access to curl or similar tool to fetch raw logs from LUCI.

Workflow

1. Find Failing Checks

You can use the gh CLI if it's installed and authenticated, or use direct HTTP requests to the GitHub API as a fallback.

Option A: Using gh CLI (Preferred)

Run the following command to list checks:

bash
gh pr checks <PR_NUMBER>
Option B: Using GitHub API via HTTP

If gh is not available, you can use read_url_content or a similar method to interact with the public GitHub API:

  1. Find the PR SHA: Make an HTTP request to: https://api.github.com/repos/flutter/flutter/pulls/<PR_NUMBER> Extract the head.sha field.
  2. List Check Runs: Make an HTTP request to: https://api.github.com/repos/flutter/flutter/commits/<PR_SHA>/check-runs Parse the JSON response. CRITICAL: You must handle pagination to avoid missing failures! Check the total_count field. If it is greater than the number of items in the check_runs array (typically capped at 100 or what you set with per_page), make additional HTTP requests by appending ?per_page=100&page=<N> to the URL for each subsequent page until all check runs are fetched. Identify all checks that have failed (i.e., where conclusion is failure).

Identify all checks that have failed.

2. Retrieve Failure Logs

For each failing check:

  1. Find the Log URL:

    • Look for the target URL or link associated with the check.
    • The flutter-dashboard link typically appears as "View more details on flutter-dashboard" at the bottom of the check view on GitHub.
    • Alternatively, you can reconstruct the link to the LUCI page based on the name of the failing check and the build number if available. Example LUCI URL structure: https://ci.chromium.org/ui/p/flutter/builders/try/<Builder Name>/<Build Number>/overview
  2. Build Raw Log URL:

    • Manual: Reconstruct the raw log URL by appending ?format=raw to the log URL or by following the pattern: https://logs.chromium.org/logs/flutter/buildbucket/cr-buildbucket/<Build ID>/+/u/<Step Name>/stdout?format=raw
  3. Fetch Raw Logs:

    • Use curl or similar tool to fetch the content of the raw log URL.
    • CRITICAL: You must use the raw log URL to avoid HTML formatting and truncated output. Do NOT rely solely on the check summary in the GitHub API, as it may be truncated or lack full context.
Builder to Step Name Mapping

[!NOTE] Step names can be very specific and hard to guess. This section documents patterns to help find them.

Show full SKILL.md (271 more words)Show less
Recipes & Tools
  • flutter_drone Recipe

    • Description: Originates from the cocoon or recipes repository. It is typically used for running sharded framework tests and lints (like analyze, test_general) as specified in .ci.yaml (root).
    • Pattern: run test.dart for <shard> shard and subshard <subshard>
    • URL Transformation: Spaces are replaced by underscores.
    • Default: If subshard is not specified, it defaults to None.
    • Example: For Linux analyze (shard: analyze, no subshard), the URL step name is run_test.dart_for_analyze_shard_and_subshard_None.
  • builder.py & Related Recipes

    • Description: Found in the flutter/engine repository (or recipes repository) and used to execute builds and tests according to target JSON configurations in the builders folder directory.
    • Pattern: Typically the task name specified in the JSON configuration, often prefixed with test: .
    • URL Transformation: Spaces are replaced by underscores.
    • Gotcha: If the test name already starts with test: in the JSON file, the recipe might still add the prefix again (e.g., test:_test:_Check_formatting).
  • tester.py

    • Description: A common helper script in the engine's CI recipes used to execute tests.
    • Pattern: Run <shard> tests or Run <shard> <subshard> tests.
    • URL Transformation: Spaces are replaced by underscores.
Locating Exact Names in Engine

If guessing fails, find the exact test and task names in the engine configuration:

  1. Look up the builder in .ci.yaml (engine) to find its config_name property.
  2. Locate the corresponding JSON file in the builders folder directory.
  3. Read the JSON file to find the tests array and the specific tasks listed within them.
Fallback

If read_url_content fails with 404 on guessed step names, you may need to find the step name from the LUCI overview page or other sources.

© flutter, BSD-3-Clause. 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 .agents/skills/flutter-pr-checks-finder of flutter/flutter.

Open the folder on GitHubat commit 8679894

Compare with similar skills

Flutter PR Checks Finder 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 PR Checks Finder compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Flutter PR Checks Finder this skillflutter/flutter179k—~1.3kAutomated safety check: PassBSD-3-Clause
Flutter Pub ReleaseMixinNetwork/flutter-plugins512—~1.3kAutomated safety check: PassMIT
flutter_soloud Setupalnitak/flutter_soloud424—~3.6kAutomated safety check: NotesMIT
Gui Testlibnativeapi/nativeapi161—~3.5kAutomated safety check: PassMIT
Fkit SetupJoker-x-dev/FlutterKit127—~720Automated safety check: PassMIT
Flutter Use HTTP Packageabdulmominsakib/localmind2611 repos~1.6kAutomated safety check: PassMIT

Similar skills

  • Flutter Pub Release

    MixinNetwork/flutter-plugins

    Prepare and draft a pub.dev release for a package in the flutter-plugins monorepo.

    512 GitHub stars~1.3k tokensUpdated 1 mo 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
  • Gui Test

    libnativeapi/nativeapi

    End-to-end test a desktop app (Flutter desktop apps and plain native executables such as C++ examples) by launching the real app, driving it with guarded synthetic mouse input — eased moves, clicks…

    161 GitHub stars~3.5k tokensUpdated yesterday
    MobileAuto-check passed
  • Fkit Setup

    Joker-x-dev/FlutterKit

    将 FlutterKit 脚手架初始化为新的应用项目,统一修改应用显示名称、Dart 包名、Android Application ID、Apple Bundle ID、Linux/Windows 标识、Web 名称、运行时品牌文案、Logo、桌面图标和启动页。用户拉取模板后要求改名、改包名、替换品牌资源或完成首次项目配置时使用。

    127 GitHub stars~720 tokensUpdated 2 mo ago
    MobileAuto-check passed
  • Flutter Use HTTP Package

    abdulmominsakib/localmind

    Use the http package to execute GET, POST, PUT, or DELETE requests.

    261 GitHub starsUsed in 1 repo~1.6k tokens
    MobileAuto-check passed
  • Run and verify Flutter desktop behavior on Windows/macOS/Linux native clients.

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

More from flutter/flutter

All 14 skills in this repo
  • 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
    Auto-check passed
  • Flutter Cherry Pick

    flutter/flutter

    How to land a formal cherry-pick of a merged PR for the flutter/flutter repo stable or beta channel.

    179k GitHub stars~1.8k tokensUpdated today
    Auto-check passed
  • Upgrade Browser

    flutter/flutter

    Upgrade browser versions (Chrome or Firefox) in the Flutter Web Engine and/or Framework tests.

    179k GitHub stars~1.1k tokensUpdated today
    Auto-check passed
  • Code Review

    flutter/flutter

    Performs a comprehensive, multi-step code review of pull requests or local code changes, using iterative refinement (generation, critique, synthesis) to ensure high-quality, actionable feedback.

    179k GitHub stars~1.4k tokensUpdated today
    Auto-check passed
  • Bump Dart

    flutter/flutter

    Do not trigger automatically; only run when a user runs /bump-dart.

    179k GitHub stars~1.2k tokensUpdated today
    Auto-check passed
  • Run Devicelab With Led

    flutter/flutter

    Run DeviceLab tests for Flutter PRs using LUCI's led CLI tool.

    179k GitHub stars~786 tokensUpdated today
    Auto-check passed

Categories

Questions about Flutter PR Checks Finder

What does Flutter PR Checks Finder do?

Find failing checks on a Flutter PR and locate the corresponding LUCI log URLs. Flutter PR Checks Finder is an agent skill from flutter/flutter. Find failing checks on a Flutter PR and locate the corresponding LUCI log URLs.

When should I use Flutter PR Checks Finder?

Flutter PR Checks Finder fits situations like: tasks that involve Cross-platform mobile apps.

How do I install Flutter PR Checks Finder in Claude Code?

Run `npx skills add flutter/flutter --skill flutter-pr-checks-finder -a claude-code`. Or copy the skill folder (.agents/skills/flutter-pr-checks-finder in flutter/flutter) into .claude/skills/flutter-pr-checks-finder in your project. Claude Code loads it when a task matches its description.

How do I install Flutter PR Checks Finder in Codex?

Run `npx skills add flutter/flutter --skill flutter-pr-checks-finder -a codex`. Or copy the skill folder (.agents/skills/flutter-pr-checks-finder in flutter/flutter) into .agents/skills/flutter-pr-checks-finder in your project. Codex loads it when a task matches its description.

Can I use Flutter PR Checks Finder 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 flutter/flutter --skill flutter-pr-checks-finder -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-pr-checks-finder, .gemini/skills/flutter-pr-checks-finder, .github/skills/flutter-pr-checks-finder and .opencode/skills/flutter-pr-checks-finder in your project.

What does Flutter PR Checks Finder need to run?

Going by SKILL.md and its folder, Flutter PR Checks Finder needs the command-line tools its instructions call (gh).

Does Flutter PR Checks Finder access the network?

SKILL.md names 4 domains. In commands or code: api.github.com, ci.chromium.org and logs.chromium.org; the agent is likely to contact these when it follows the instructions. As links in the text: github.com. This is read from the text; nothing was executed.

Is Flutter PR Checks Finder 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 PR Checks Finder use?

Flutter PR Checks Finder is published under the BSD-3-Clause licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Flutter PR Checks Finder use?

About 1.3k tokens (SKILL.md is roughly 5.3k 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 PR Checks Finder?

Skills that share tags, products or a category with Flutter PR Checks Finder: Flutter Pub Release (MixinNetwork/flutter-plugins, 512 stars), flutter_soloud Setup (alnitak/flutter_soloud, 424 stars), Gui Test (libnativeapi/nativeapi, 161 stars) and Fkit Setup (Joker-x-dev/FlutterKit, 127 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Flutter PR Checks Finder?

flutter (a GitHub organization) maintains it in flutter/flutter, which has 179,369 GitHub stars. The repository holds 14 skills in this directory. The repository was last updated on October 8, 2026.

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