Agent skill

Flutter Pub Release

by MixinNetwork in MixinNetwork/flutter-plugins

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

MITAuto-check passedMobile

Install Flutter Pub Release

skills CLI
$ npx skills add MixinNetwork/flutter-plugins --skill flutter-pub-release -a claude-code

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

GitHub CLI
$ gh skill install MixinNetwork/flutter-plugins flutter-pub-release --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/MixinNetwork/flutter-plugins.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.codex/skills/flutter-pub-release .claude/skills/flutter-pub-release && 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-pub-release
GitHub stars
512
Token cost
~1.3k tokens
SKILL.md length
523 words
Files
2 (incl. scripts)
Skills in repo
1
Repo updated
First seen
Licence
MIT

At a glance

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

  • The user wants to generate changelog entries from commits since the last {package}-v tag
  • SKILL.md covers Workflow and Notes
  • Runs Python scripts from its folder; calls python3, git and dart; reaches github.com
  • Bump the package version in pubspec.yaml

What it does

Flutter Pub Release is an agent skill from MixinNetwork/flutter-plugins. Prepare and draft a pub.dev release for a package in the flutter-plugins monorepo. Use when the user wants to generate changelog entries from commits since the last {package}-v tag, bump the package version in pubspec.yaml, update CHANGELOG.md, and draft a GitHub release whose tag is {package}-v{version} for .github/workflows/publish.yml.

Its SKILL.md is about 1.3k tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files, including scripts (for example `scripts/release_helper.py`).

It sits in Mobile, covering Cross-platform mobile apps, Changelog and release notes and Monorepo tooling. It works with Flutter, GitHub Actions, GitHub and Dart. The repository describes itself as: 🧱 Flutter plugins used in Mixin Messenger. The licence is MIT.

When your agent uses it

  • The user wants to generate changelog entries from commits since the last {package}-v tag
  • Bump the package version in pubspec.yaml
  • Update CHANGELOG.md
  • Draft a GitHub release whose tag is {package}-v{version} for .github/workflows/publish.yml

Example prompts

  • “/flutter-pub-release”

Requirements

  • Python 3

What it can do on your machine

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

    Ships 1 file in scripts/ (Python), which the agent can run.

    Shell commands in SKILL.md call:

    • python3
    • git
    • dart
    • 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:

    • 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 Pub Release loads about 1.3k tokens when it runs. Until then it costs about 93 tokens; SKILL.md has 523 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~93
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); the scripts in this folder are not scanned.

SKILL.md

The full file from MixinNetwork/flutter-plugins at commit 38dfe33, republished under its MIT licence (© MixinNetwork). 523 words, ~1,275 tokens.

Download SKILL.mdSave it as .claude/skills/flutter-pub-release/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
flutter-pub-release
description
Prepare and draft a pub.dev release for a package in the flutter-plugins monorepo. Use when the user wants to generate changelog entries from commits since the last `{package}-v*` tag, bump the package version in `pubspec.yaml`, update `CHANGELOG.md`, and draft a GitHub release whose tag is `{package}-v{version}` for `.github/workflows/publish.yml`.

Flutter Pub Release

Use this skill for package releases inside this repository.

Repository assumptions:

  • Package source lives at packages/<package>/.
  • Package version lives in packages/<package>/pubspec.yaml.
  • Package changelog lives in packages/<package>/CHANGELOG.md.
  • Example lockfile lives at packages/<package>/example/pubspec.lock when the package has an example app.
  • Publish tags use {package}-v{version} and are consumed by .github/workflows/publish.yml.

Core rules:

  • Generate changelog entries from commits touching packages/<package>/ since the latest {package}-v* tag.
  • Let the model inspect the actual code changes, public API surface, tests, examples, and commit context to judge whether this release is a breaking change.
  • If the model judges it as breaking, bump the minor version and reset patch to 0.
  • Otherwise bump the patch version.
  • Keep release notes and CHANGELOG.md in the same format.
  • For PRs from other contributors, render entries exactly like:
md
* fix build on android [#285](https://github.com/MixinNetwork/flutter-plugins/pull/285)
  by [AdamVe](https://github.com/AdamVe)

Workflow

  1. Verify repo state before editing.
  • Run gh auth status.
  • Prefer a clean worktree before release prep.
  1. Preview the release plan.
  • First inspect the package diff since the latest release tag and decide the bump in-model. Do not rely on a regex or commit-message heuristic for breaking-change detection.
  • Useful checks:
    • git diff <previous-tag>..HEAD -- packages/<package>
    • git log --oneline <previous-tag>..HEAD -- packages/<package>
    • public exports under packages/<package>/lib/
    • matching tests, README, and example/ changes when relevant
  • Run:
bash
python3 .codex/skills/flutter-pub-release/scripts/release_helper.py plan <package> --bump patch
  • Use --bump minor when the model believes the change is breaking.

  • Use --version x.y.z if you want to pin the exact version directly.

  • This prints JSON with:

    • previous tag
    • next version
    • tag name
    • rendered changelog section
  1. Apply the release files when the user wants the change written.
  • Run:
bash
python3 .codex/skills/flutter-pub-release/scripts/release_helper.py apply <package> --bump patch
  • This updates:

    • packages/<package>/pubspec.yaml
    • packages/<package>/CHANGELOG.md
    • packages/<package>/example/pubspec.lock when present
  • Then run dependency resolution from the package directory so lock/state stays consistent with the new version:

bash
cd packages/<package>
dart pub get
  1. Validate narrowly.
  • Run package-scoped checks only when they are fast and relevant.
  • Do not expand into repo-wide validation unless the change genuinely spans packages.
  1. Commit and validate before drafting the release.
  • Use an English commit message such as:
Show full SKILL.md (209 more words)Show less
text
chore(release): prepare <package> <version>
  • Commit the release changes directly on main.
  • After commit, run a publish dry-run from the package directory and fix any reported errors:
bash
cd packages/<package>
dart pub publish --dry-run
  1. Push main.
bash
git push origin main
  • The release commit must exist on GitHub before it can be used as a draft release target.
  • If the push is rejected, stop and report the failure. Do not force-push.
  1. Draft the GitHub release.
  • Run:
bash
python3 .codex/skills/flutter-pub-release/scripts/release_helper.py draft-release <package>
  • The script reads the current package version, extracts the matching changelog section, and creates a draft GitHub release with:

    • tag: {package}-v{version}
    • title: {package}-v{version}
    • notes: the same changelog section
    • target: current HEAD (the release commit you just made)
  • The helper requires the current HEAD to be present on origin/main, then anchors the draft tag to that exact commit.

  • Stop there. Do not try to verify whether the tag exists remotely or whether .github/workflows/publish.yml has started running. This workflow is only responsible for preparing the draft release.

Notes

  • The script detects PR numbers from squash-merge subjects like (#123).
  • The script does not decide whether a release is breaking. The model must decide that before calling plan or apply.
  • If the user wants to override the bump, use:
bash
python3 .codex/skills/flutter-pub-release/scripts/release_helper.py plan <package> --bump minor
python3 .codex/skills/flutter-pub-release/scripts/release_helper.py apply <package> --version 0.2.0
  • If the package has no previous tag, stop and ask the user how they want the first release version handled instead of guessing.

© MixinNetwork, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 1 other file (scripts) in .codex/skills/flutter-pub-release of MixinNetwork/flutter-plugins.

  • SKILL.md
  • scripts/release_helper.py

Open the folder on GitHubat commit 38dfe33

Compare with similar skills

Flutter Pub Release 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 Pub Release compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Flutter Pub Release this skillMixinNetwork/flutter-plugins512—~1.3kAutomated safety check: PassMIT
Layered ArchitectureVeryGoodOpenSource/vgv-ai-flutter-plugin169—~4.6kAutomated safety check: PassMIT
Code Guidelinesgetsentry/sentry-dart873—~2.2kAutomated safety check: PassMIT
Frb Upgrade Flutterfzyzcjy/flutter_rust_bridge5.4k—~1.7kAutomated safety check: PassMIT
Test Guidelinesgetsentry/sentry-dart873—~3.1kAutomated safety check: PassMIT
Automate npm Releasejd-solanki/slidev-theme-dracula161—~626Automated safety check: PassNone

Similar skills

  • Layered Architecture

    VeryGoodOpenSource/vgv-ai-flutter-plugin

    VGV layered monorepo architecture in Flutter: four layers Data, Repository, Business Logic, and Presentation, unidirectional dependency rules, and model transformation across layers.

    169 GitHub stars~4.6k tokensUpdated yesterday
    MobileAuto-check passed
  • Code Guidelines

    getsentry/sentry-dart

    Official

    Enforce Sentry Dart/Flutter SDK code guidelines for implementation, refactoring, and review.

    873 GitHub stars~2.2k tokensUpdated yesterday
    DevelopmentAuto-check passed
  • Frb Upgrade Flutter

    fzyzcjy/flutter_rust_bridge

    Upgrade flutterrustbridge to a new Flutter stable release. An agent skill from fzyzcjy/flutter_rust_bridge.

    5.4k GitHub stars~1.7k tokensUpdated yesterday
    MobileAuto-check passed
  • Test Guidelines

    getsentry/sentry-dart

    Official

    Enforce Sentry Dart/Flutter SDK test conventions for naming, structure, and fixtures.

    873 GitHub stars~3.1k tokensUpdated yesterday
    Testing & QAAuto-check passed
  • Automate npm Release

    jd-solanki/slidev-theme-dracula

    Automate npm package publishing via GitHub Actions for single-package repos and independent monorepo packages, including bumpp version tags, GitHub release notes, trusted publishing, provenance, and…

    161 GitHub stars~626 tokensUpdated 3 mo ago
    DevelopmentAuto-check passed
  • Update Dependencies

    sesori-ai/sesori_apps_monorepo

    Weekly dependency update workflow for Sesori Apps Monorepo. An agent skill from sesori-ai/sesori_apps_monorepo.

    125 GitHub stars~7.8k tokensUpdated yesterday
    DevelopmentAuto-check passed

Questions about Flutter Pub Release

What does Flutter Pub Release do?

Prepare and draft a pub.dev release for a package in the flutter-plugins monorepo. Flutter Pub Release is an agent skill from MixinNetwork/flutter-plugins.dev release for a package in the flutter-plugins monorepo.

When should I use Flutter Pub Release?

Flutter Pub Release fits situations like: the user wants to generate changelog entries from commits since the last {package}-v tag; bump the package version in pubspec.yaml; update CHANGELOG.md; draft a GitHub release whose tag is {package}-v{version} for .github/workflows/publish.yml.

How do I install Flutter Pub Release in Claude Code?

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

How do I install Flutter Pub Release in Codex?

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

Can I use Flutter Pub Release 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 MixinNetwork/flutter-plugins --skill flutter-pub-release -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-pub-release, .gemini/skills/flutter-pub-release, .github/skills/flutter-pub-release and .opencode/skills/flutter-pub-release in your project.

What does Flutter Pub Release need to run?

Going by SKILL.md and its folder, Flutter Pub Release needs Python for the scripts in its folder and the command-line tools its instructions call (python3, git, dart and gh). Our summary lists: Python 3.

Does Flutter Pub Release access the network?

SKILL.md names 1 domain. In commands or code: github.com; the agent is likely to contact it when it follows the instructions. This is read from the text; nothing was executed.

Is Flutter Pub Release 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. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Flutter Pub Release use?

Flutter Pub Release 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 Pub Release use?

About 1.3k tokens (SKILL.md is roughly 5.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 Pub Release?

Skills that share tags, products or a category with Flutter Pub Release: Layered Architecture (VeryGoodOpenSource/vgv-ai-flutter-plugin, 169 stars), Code Guidelines (getsentry/sentry-dart, 873 stars), Frb Upgrade Flutter (fzyzcjy/flutter_rust_bridge, 5.4k stars) and Test Guidelines (getsentry/sentry-dart, 873 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Flutter Pub Release?

MixinNetwork (a GitHub organization) maintains it in MixinNetwork/flutter-plugins, which has 512 GitHub stars. The repository was last updated on September 1, 2026.

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