OpenParable
Skip to content
← Back to skills

Find Release

Research
find-release

Find Release is an Agent Skill for research published in the flutter/flutter repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

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.

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/flutter/flutter/blob/HEAD/.agents/skills/find-release/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/find-release, but wait for my approval before writing files or running scripts.

Copying this prompt does not install or run the skill. Review third-party files before use.

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.