Labsco
flutter logo

find-release

✓ Official177,600

by flutter · part of flutter/flutter

A skill to find the lowest Dart and Flutter release containing a given commit. Use this skill whenever users ask about when a commit landed in Flutter or Dart…

🔥🔥🔥✓ VerifiedFreeQuick setup
🧰 Not standalone. This skill ships with flutter/flutter and only works together with that tool — install the tool first, then add this skill.

A skill to find the lowest Dart and Flutter release containing a given commit. Use this skill whenever users ask about when a commit landed in Flutter or Dart…

Inspect the full instructions your agent will receiveExpand

This is the exact playbook injected into your agent when the skill activates — shown here so you can audit it before installing. You don't need to read it to use the skill.


name: find-release description: A skill to find the lowest Dart and Flutter release containing a given commit. Use this skill whenever users ask about when a commit landed in Flutter or Dart releases, inquire about release versions for specific SHAs, or want to know if a commit is included in stable, beta, or dev channels for Flutter/Dart projects.

Instructions

  1. Extract Information:

    • Identify the commit SHA from the user's request (e.g., 02abc57).
    • Identify the target channel (one of: stable, beta, dev). If not specified, try each.
  2. Execute Search:

    • Ensure the find_release.dart tool is available. The tool is typically located at find_release.dart relative to the Flutter workspace root. If the workspace root is not the default, set the environment variable FIND_RELEASE_TOOL_PATH to the absolute path of the tool.
    • Run the tool using the path to ensure it works from any directory within the workspace.
    • Command: dart run ${FIND_RELEASE_TOOL_PATH:-engine/src/flutter/third_party/dart/tools/find_release.dart} --commit=<SHA> --channel=<CHANNEL>
  3. Interpret and Report Results:

    • The tool will report which repository (dart-lang/sdk or flutter/flutter) the commit was found in.
    • It will provide the "Lowest release tag" (the git tag containing the commit).
    • It will provide the "Lowest Flutter release" and/or "Lowest Dart release" version for the specified channel.
    • Present these findings clearly to the user. If the commit is not found or not yet in a release for that channel, inform the user accordingly.
    • Handle edge cases: If the SHA is invalid or not found, suggest checking the SHA. If the channel is invalid, default to stable and notify the user.

Examples

  • User: "When did commit 02abc57 land in stable?"

  • Agent: Runs dart run ${FIND_RELEASE_TOOL_PATH:-engine/src/flutter/third_party/dart/tools/find_release.dart} --commit=02abc57 --channel=stable and reports the release version.

  • User: "Is 02abc57 in beta?"

  • Agent: Runs the command with --channel=beta.