sample-release-notes

Generate release notes from git diffs by asking the agent to analyze changes in the current branch compared to main. It inspects commit history and diffs to identify user-visible updates, producing a concise summary of new features and bug fixes for stakeholders.

Writing changelogs that focus on user-facing features requires behavioral analysis of code changes. This skill filters out noise like internal refactoring and dependency updates, translating technical repository changes into clear, user-friendly documentation that highlights actual value.

Yes, you can draft documentation for a software deployment using a pull request diff. The skill analyzes the pull request changes to distinguish between observable behavior updates and internal code modifications, ensuring release notes communicate new features and fixes clearly.

Generating release notes requires access to repository commit history and diffs to accurately distinguish observable behavior changes from internal refactoring. Providing access to the git diff between your current branch and the main branch allows the skill to summarize user-facing updates effectively.

Filtering internal refactoring and dependency updates from your changelog ensures stakeholders understand the actual value delivered. The skill applies concise summarization to remove technical noise, focusing the release notes strictly on user-visible behavior changes, feature updates, and bug fixes.