skills.rest
kiranimmadi2
kiranimmadi2COMMUNITY
Explore all skills by this author →
WebsiteGitHub

release

Automates semver versioning, changelogs, pub.dev publishing, and GitHub releases for Dart monorepo packages.

Updated May 23, 2026
Search Tags:#changelog#github#release#monorepo#semver#dart#pub.dev
One-click install
npx skills add https://github.com/kiranimmadi2/promptforge-ai --skill release-kiranimmadi2
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: release
Source: https://github.com/kiranimmadi2/promptforge-ai/tree/main/ai_clients_dart/.agents/skills/release
Command: npx skills add https://github.com/kiranimmadi2/promptforge-ai --skill release-kiranimmadi2

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Releasing packages in a Dart monorepo involves many error-prone manual steps: detecting which packages changed, computing correct semver bumps, writing changelogs and migration guides, publishing to pub.dev, and creating git tags and GitHub releases. This Skill orchestrates the entire release lifecycle with validation checkpoints and recovery guidance. ## Core Features & Use Cases - Change Detection & Semver Bumping: Parses conventional commits since the last release tag per package, filters non-publishable changes via .pubignore, detects pre-applied version bumps, and computes major/minor/patch bumps with pre-1.0 rules. - PR-Enriched Changelogs & Migration Guides: Fetches PR descriptions via a subagent to verify semver decisions and write user-facing changelog summaries, breaking-change notes, and MIGRATION.md entries. - Safe Publishing Workflow: Supports --plan and --dry-run modes, runs dart pub publish dry-runs, publishes packages in workspace order, creates per-package tags, and generates a combined GitHub release with a reconciliation checkpoint. - Use Case: Run the release workflow after merging several PRs to automatically bump versions, update CHANGELOG.md and README quickstart snippets, publish to pub.dev, and tag the release — with a resumption guide if the process is interrupted. ## Quick Start Ask the AI to run the release skill in plan mode to preview version bumps and changelogs for all changed packages in the monorepo.

Frequently Asked Questions about release

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I release Dart packages in a monorepo to pub.dev?▼

Run the release skill, which detects changed packages since their last tags, computes semver bumps from conventional commits, updates changelogs and pubspec versions, then publishes each package with dart pub publish in workspace order before tagging and creating a GitHub release.

How are semantic version bumps determined from commits?▼

Commits are parsed as conventional commits: feat triggers minor, fix/refactor/perf/docs trigger patch, and any breaking change triggers major. For pre-1.0 packages, breaking changes bump minor and features bump patch, with an option to promote to 1.0.0.

Can I preview a release without publishing or modifying files?▼

Yes, use --plan mode to see detected changes, computed version bumps, and the release plan without editing files, and use --dry-run mode to perform all edits plus dart pub publish --dry-run while restoring the working tree afterward.

What happens if a release is interrupted mid-process?▼

The references/resumption-guide.md document explains how to assess current state with git and gh commands and resume from the correct step. A progress file tracks completed steps, and a recovery table covers every interruption point.

Does the release handle breaking changes and migration guides?▼

Yes, breaking changes are detected from commit markers and PR descriptions, changelogs get a CAUTION admonition, and MIGRATION.md files are created or updated with before/after migration instructions per package.

Why might a package be skipped during release detection?▼

Packages are skipped when they have no release-triggering commits since the last tag, or when all changed files fall under .pubignore directory entries like .agents or specs. A pre-applied pubspec version bump ahead of the latest tag overrides the skip.

Related Skills

Explore More Software Engineering Skills→
Fabric-ProFabric-Pro
3

changelog-generator

Generate changelogs and release notes from Git commit history.

Official
Basic
MelbourneDeveloperMelbourneDeveloper
113

release

Automate Dart package versioning, dependency updates, and publishing to pub.dev.

Community
Advanced
RoxabiRoxabi
9

promote

Automate staging-to-main branch promotion with pre-flight checks, versioning, and pull request creation.

Official
Advanced
auravibes-appsauravibes-apps

melos-7

Configure Dart/Flutter monorepos for Melos 7+ workspace conventions.

Official
Advanced