MF

Streamlines release preparation by automating versioning, changelog updates, and dependency locking.

Install

mkdir -p .claude/skills/mflux-release && curl -L -o skill.zip "https://agentskills.codes/api/skills/download/4636" && unzip -o skill.zip -d .claude/skills/mflux-release && rm skill.zip

Installs to .claude/skills/mflux-release

Activation

This is the description your AI agent reads to decide when to run this skill — the better it matches your request, the more reliably it fires.

Prepare a release in mflux (version bump, changelog, contributors, uv lock) without tagging/publishing. Use when preparing a release branch or release PR.
154 chars✓ has a “when” trigger
Beginner

Key capabilities

  • Bump project versions in pyproject.toml
  • Generate changelog entries from commit history
  • Extract contributor handles from merged PRs
  • Update uv lockfiles
  • Prepare release branches

How it works

The skill automates the modification of versioning and documentation files in the repository to prepare for a release PR.

Inputs & outputs

You give it
Release version and commit history
You get back
Updated project files and changelog

When to use mflux-release

  • Bump project version
  • Generate release changelog
  • Update uv lockfile

About this skill

mflux release prep

Releases are prepared in-repo; tagging/publishing is handled by GitHub Actions.

When to Use

  • You’re preparing a release PR.
  • You need to bump version and update the changelog/lockfile correctly.

Instructions

  • Checklist:
    • Bump version in pyproject.toml
    • Review commits since last release tag:
      • git log --oneline v.<last-version>..HEAD
    • Browse relevant file contents if needed to clarify changes
    • Weigh commit impact: some are minor; skim earlier changelog entries to gauge what's worth reporting vs tiny fixes
    • Add a descriptive entry to CHANGELOG.md based on those commits
    • Always add a ### 👩‍💻 Contributors section to the new changelog entry
    • Source contributor names from merged GitHub PR authors for the changes included in the release, and format them as @handle
    • Prefer one release commit for the release prep work on the branch
    • Name that commit Release <version>
    • Prefer GitHub data over local git author names:
      • Use gh pr list --state merged / related gh queries when available
      • Do not assume gh is installed; if it is unavailable, inspect GitHub on the web instead
      • General pages to check on the web:
        • Closed PRs: https://github.com/<owner>/<repo>/pulls?q=is%3Apr+is%3Aclosed
        • Compare view for release range: https://github.com/<owner>/<repo>/compare/v.<last-version>...HEAD
        • Specific PR page when you know the PR number: https://github.com/<owner>/<repo>/pull/<number>
      • Map included changes to merged PR authors from those pages
    • Do not invent handles, and do not treat local-only commits as contributors unless the user explicitly wants that
    • Update lockfile: uv lock
    • Sanity checks (optional unless requested): make test-fast, make build
    • Manual checks (optional): if the release includes CLI/callback/image-path changes, consider running the mflux-manual-testing skill to exercise the touched commands and visually review outputs.
  • Do not tag releases locally unless explicitly requested (normally handled by CI).

When not to use it

  • Publishing releases to package registries
  • Tagging releases locally

Limitations

  • Requires manual review of commit impact
  • Contributor data relies on GitHub PR metadata

How it compares

It prepares release metadata and documentation in-repo rather than performing the actual publishing or tagging.

Compared to similar skills

mflux-release side by side with the closest alternatives in the catalog.

SkillInstallsUpdatedSafetyDifficulty
mflux-release (this skill)15moNo flagsBeginner
codex-cli-bridge99moReviewIntermediate
code-changelog09moReviewBeginner
dev26moReviewAdvanced

Try saying

Example prompts that trigger this skill in your AI assistant.

Search skills

Search the agent skills registry