maui-release-notes_skill

Overview

This skill generates and updates .NET MAUI workload release notes as well-formatted Markdown. It produces a dated detailed notes file and updates a consolidated index with per-.NET-version summaries, platform dependency requirements, and installation instructions. Use the skill to document current workload versions, detect new workload releases, or produce publication-ready release-note pages.

How this skill works

The skill fetches live workload metadata for the two most recent stable .NET versions via the dotnet-workload-info skill, including workload set versions, individual workload versions, MAUI NuGet package versions, and platform dependencies (Xcode, JDK, Android SDK). It compares the fetched versions to the latest existing release notes; if any key version changed, it generates a new dated notes file and prepends a summary entry to the index. All output is formatted as Markdown with links to NuGet and GitHub releases, and platform requirements presented in a Requirements column.

When to use it

• Create release notes when new MAUI workload sets or workload components are released.
• Update documentation after a dotnet workload update or new MAUI NuGet package publish.
• Check whether workloads are already up to date before posting announcements.
• Generate consistent, linked Markdown for release channels or internal change logs.

Best practices

• Always fetch live data via the dotnet-workload-info skill; do not use cached versions.
• Compare workload set, MAUI, iOS, and Android versions — treat any change as a trigger to generate notes.
• Include only .NET versions with actual changes in the index entry to keep the index concise.
• Use the Requirements column for platform constraints (Xcode, API level, JDK) to help users install correctly.
• Use established link patterns for NuGet and GitHub to ensure stable references.

Example use cases

• Produce a new release-notes file and index entry after .NET MAUI workloads are updated for .NET 10.
• Generate a quick summary page showing current MAUI and platform dependency versions for an engineering blog.
• Run a daily check to report whether workload versions are up to date or require a release-note update.
• Convert live workload data into documented installation instructions for CI/CD or developer onboarding.