Agent skill

Bump Dart

by flutter in flutter/flutter

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

BSD-3-ClauseAuto-check passedMobile

Install Bump Dart

skills CLI
$ npx skills add flutter/flutter --skill bump-dart -a claude-code

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

GitHub CLI
$ gh skill install flutter/flutter bump-dart --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/bump-dart .claude/skills/bump-dart && 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
bump-dart
GitHub stars
179k
Token cost
~1.2k tokens
SKILL.md length
586 words
Files
1
Skills in repo
14
Repo updated
First seen
Licence
BSD-3-Clause

At a glance

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

  • Works in 5 steps: Pre-flight Checks → Update pubspec.yaml Files → Update Dependency Checksums and Hashes → …
  • Only run when a user runs /bump-dart
  • SKILL.md covers Important Rules and Step-by-Step Workflow
  • Calls flutter, dart and git

What it does

Bump Dart is an agent skill from flutter/flutter. Do not trigger automatically; only run when a user runs /bump-dart. Bump the minimum Dart SDK version constraint across the flutter/flutter repository, update dependency checksums, and run verification.

Its SKILL.md is about 1.2k 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 Dart and Flutter. 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

  • Only run when a user runs /bump-dart
  • Tasks that involve Cross-platform mobile apps

Example prompts

  • “/bump-dart”

Workflow steps

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

  1. Pre-flight Checks
  2. Update pubspec.yaml Files
  3. Update Dependency Checksums and Hashes
  4. Run Static Analysis
  5. Report Status, Write Results File, and Prepare Pull Request

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:

    • flutter
    • dart
    • git

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

  • Network

    No URLs in SKILL.md. Its commands use git, which can reach the network depending on how they are called.

    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

Bump Dart loads about 1.2k tokens when it runs. Until then it costs about 53 tokens; SKILL.md has 586 words of instructions outside code blocks.

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

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). 586 words, ~1,160 tokens.

Download SKILL.mdSave it as .claude/skills/bump-dart/SKILL.md (or your agent's skills folder).
name
bump-dart
description
Do not trigger automatically; only run when a user runs /bump-dart. Bump the minimum Dart SDK version constraint across the flutter/flutter repository, update dependency checksums, and run verification.

Bumping the Dart SDK Version Constraint

Important Rules

  1. Never Update Dependencies to 'any': The skill must never change or update any dependency version constraint to any in order to resolve version conflicts.
  2. Pause and Ask on Issues: If you run into any issues executing the task (e.g., version resolution failures, checksum mismatches, test failures, or analyzer errors), do not attempt to fix them by modifying other dependencies. Pause immediately, report the exact error details, and ask the user for instructions.
  3. Handle Language Feature Version Discrepancies: If static analysis fails because a package uses language features from a newer SDK version than the requested target (e.g., private-named-parameters in widget_preview_scaffold requiring 3.12.0), ask the user if that specific package should be targeted at the higher SDK version while the rest of the repository remains at the requested target.

Step-by-Step Workflow

Follow these steps carefully to perform the bump, resolve dependencies, and verify the changes.

Step 1: Pre-flight Checks
  1. Verify target version suffix: Ensure the version constraint specified by the user includes the -0 pre-release suffix (e.g., ^3.13.0-0 instead of ^3.13.0).
    • Why: Standard caret constraints like ^3.13.0 exclude pre-release versions of that major/minor release. Since active development and CI run on pre-releases, omitting the -0 suffix will cause package resolution to fail. If the user provided a version without -0, append it or ask the user for confirmation.
  2. Ensure SDK is already rolled: The target Dart SDK version must already have rolled into the repository (e.g. the local Dart SDK from the Engine stamp is at least that version). Otherwise, package resolution and analysis will fail.
Step 2: Update pubspec.yaml Files

Run the repository's Dart tool script to update matching pubspec.yaml files cross-platform:

bash
dart dev/tools/bin/bump_version_constraints.dart <OLD_VERSION_CONSTRAINT> <NEW_VERSION_CONSTRAINT>

Example: dart dev/tools/bin/bump_version_constraints.dart ^3.10.0-0 ^3.11.0-0

  • The script only updates packages whose current SDK constraint matches <OLD_VERSION_CONSTRAINT>. If it encounters packages with deviating constraints (e.g. higher SDK versions like ^3.12.0 or custom ranges), it leaves them untouched and prints a message flagging them to the user.
Step 3: Update Dependency Checksums and Hashes

Flutter enforces dependency integrity via checksums. Run the update-packages tool to re-solve the package workspace, generate updated pubspec.lock files, and update the checksums:

bash
flutter update-packages --force-upgrade --update-hashes
Show full SKILL.md (226 more words)Show less
Step 4: Run Static Analysis

Verify the new constraints solve correctly and do not introduce any analyzer errors, warnings, lints (infos), or deprecations.

Run static analysis:

bash
flutter analyze --flutter-repo
  • Treat any non-zero exit code from flutter analyze as a failure. Do not ignore info (lint) or warning diagnostics, as the Flutter repository requires all analysis issues to be clean. Pay close attention to newly firing lints or deprecated lint rule warnings.
Step 5: Report Status, Write Results File, and Prepare Pull Request
  1. Write Results File in Workspace Root: Always write a detailed report of the bump execution to a file named bump_results.md in the workspace root (e.g., <flutter_root>/bump_results.md). The file must include:
    • Target SDK version and current Engine SDK version.
    • The exact bump command run.
    • Count/details of updated pubspec.yaml files.
    • List of skipped/flagged packages with their constraints.
    • Results of the update-packages and static analysis runs (highlighting any failures, warnings, or newly firing lints).
  2. Handle Failure/Success:
    • If static analysis fails (even if it only contains info or warning diagnostics like prefer_initializing_formals or deprecated_lint), list the failures/warnings in bump_results.md, report them to the user, and ask for guidance (or proceed to fix them if instructed).
    • If static analysis passes, point the user to bump_results.md in the workspace root, show a summary of modified files (git status), and prompt the user to commit the changes and prepare a pull request.

© 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/bump-dart of flutter/flutter.

Open the folder on GitHubat commit 8679894

Compare with similar skills

Bump Dart 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.

Bump Dart compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Bump Dart this skillflutter/flutter179k—~1.2kAutomated safety check: PassBSD-3-Clause
Flutter Pub ReleaseMixinNetwork/flutter-plugins512—~1.3kAutomated safety check: PassMIT
Liquid Glass Widgetssdegenaar/liquid_glass_widgets712—~3.8kAutomated safety check: PassMIT
Flutter Bloc and Cubitandrewyng/context-hub14k—~998Automated safety check: PassMIT
Solidnank1ro/solid165—~3.1kAutomated safety check: PassMIT
Sync Cbl Docscbl-dart/cbl-dart152—~2kAutomated safety check: PassApache-2.0

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
  • Liquid Glass Widgets

    sdegenaar/liquid_glass_widgets

    Mastery guide and architectural rules for liquidglasswidgets.

    712 GitHub stars~3.8k tokensUpdated today
    MobileAuto-check passed
  • Flutter Bloc and Cubit

    andrewyng/context-hub

    Helps choose between Bloc and Cubit in Flutter and sets defaults for packages, lifecycle, widget binding and tests.

    14k GitHub stars~998 tokensUpdated 4 mo ago
    MobileAuto-check passed
  • Solid

    nank1ro/solid

    PRIORITY — read this skill FIRST before writing Dart code when pubspec.yaml declares solidannotations or solidgenerator.

    165 GitHub stars~3.1k tokensUpdated 1 mo ago
    MobileAuto-check passed
  • Sync Cbl Docs

    cbl-dart/cbl-dart

    Sync a Couchbase Lite for Dart documentation page with the official Couchbase Lite docs.

    152 GitHub stars~2k tokensUpdated 12 days ago
    MobileAuto-check passed
  • Flutter SoLoud Audio Filters

    alnitak/flutter_soloud

    Explains how to add and tune flutter_soloud's 13 audio filters at global, per-sound and mixing-bus level, including activation order and parameter fades.

    424 GitHub stars~2.1k 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
  • 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
  • Shepherd PRs

    flutter/flutter

    Automate shepherding, checking status, updating branches, and landing open PRs or approved third-party contributor PRs in the flutter/flutter repository using the gh CLI.

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

Works with

Categories

Questions about Bump Dart

What does Bump Dart do?

Do not trigger automatically; only run when a user runs /bump-dart. Bump Dart is an agent skill from flutter/flutter. Do not trigger automatically; only run when a user runs /bump-dart.

When should I use Bump Dart?

Bump Dart fits situations like: only run when a user runs /bump-dart; tasks that involve Cross-platform mobile apps.

How do I install Bump Dart in Claude Code?

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

How do I install Bump Dart in Codex?

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

Can I use Bump Dart 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 bump-dart -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/bump-dart, .gemini/skills/bump-dart, .github/skills/bump-dart and .opencode/skills/bump-dart in your project.

What does Bump Dart need to run?

Going by SKILL.md and its folder, Bump Dart needs the command-line tools its instructions call (flutter, dart and git).

Does Bump Dart access the network?

SKILL.md contains no URLs. Its commands use git, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Bump Dart 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 Bump Dart use?

Bump Dart 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 Bump Dart use?

About 1.2k tokens (SKILL.md is roughly 4.6k 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 Bump Dart?

Skills that share tags, products or a category with Bump Dart: Flutter Pub Release (MixinNetwork/flutter-plugins, 512 stars), Liquid Glass Widgets (sdegenaar/liquid_glass_widgets, 712 stars), Flutter Bloc and Cubit (andrewyng/context-hub, 14k stars) and Solid (nank1ro/solid, 165 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Bump Dart?

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.