Release Notes Generator Generate release notes and changelogs by parsing conventional commit messages from git log history. Commits following the Conventional Commits specification (feat:, fix:, docs:, etc.) are categorized, grouped, and formatted into professional markdown output. Workflow Step 1: Determine Output Type Ask the user what they need: - Release Notes — a single release summary written to - Changelog — append to an existing (or create one) - Both — generate both files Step 2: Determine Commit Range Identify which commits to include. Two approaches: Since last tag (default): The p…

\nFOOTER_RE='^([A-Za-z-]+|BREAKING CHANGE)(: | #)(.*)

Release Notes Generator Generate release notes and changelogs by parsing conventional commit messages from git log history. Commits following the Conventional Commits specification (feat:, fix:, docs:, etc.) are categorized, grouped, and formatted into professional markdown output. Workflow Step 1: Determine Output Type Ask the user what they need: - Release Notes — a single release summary written to - Changelog — append to an existing (or create one) - Both — generate both files Step 2: Determine Commit Range Identify which commits to include. Two approaches: Since last tag (default): The p…

\nBREAKING_RE='^BREAKING[\\ -]CHANGE'\n\n# Process a single commit from its hash and message lines.\n# Globals: COMMIT_RE, FOOTER_RE, BREAKING_RE (read-only)\n# Arguments: None — reads HASH and LINES global variables\nprocess_commit() {\n local subject=\"${LINES[0]:-}\"\n local type scope bang desc body footers in_footer breaking start\n\n # Parse conventional commit subject\n if [[ \"$subject\" =~ $COMMIT_RE ]]; then\n type=\"${BASH_REMATCH[1]}\"\n scope=\"${BASH_REMATCH[3]:-}\"\n bang=\"${BASH_REMATCH[4]:-}\"\n desc=\"${BASH_REMATCH[5]}\"\n else\n # Not a conventional commit — classify as \"other\"\n type=\"other\"\n scope=\"\"\n bang=\"\"\n desc=\"$subject\"\n fi\n\n body=\"\"\n footers=\"\"\n in_footer=false\n breaking=\"no\"\n\n if [[ \"$bang\" == \"!\" ]]; then\n breaking=\"yes\"\n fi\n\n # Process remaining lines (skip subject and blank line after it)\n start=1\n if [[ ${#LINES[@]} -gt 1 && -z \"${LINES[1]:-}\" ]]; then\n start=2\n fi\n\n for ((i=start; i\u003c${#LINES[@]}; i++)); do\n local line=\"${LINES[$i]}\"\n\n # Check for footer pattern: \"Token: value\" or \"Token #value\" or \"BREAKING CHANGE: value\"\n if [[ \"$line\" =~ $FOOTER_RE ]]; then\n in_footer=true\n fi\n\n if $in_footer; then\n if [[ -n \"$footers\" ]]; then\n footers=\"${footers}\\n${line}\"\n else\n footers=\"$line\"\n fi\n # Check for BREAKING CHANGE footer\n if [[ \"$line\" =~ $BREAKING_RE ]]; then\n breaking=\"yes\"\n fi\n else\n if [[ -n \"$body\" ]]; then\n body=\"${body}\\n${line}\"\n else\n body=\"$line\"\n fi\n fi\n done\n\n echo \"COMMIT:${HASH}\"\n echo \"TYPE:${type}\"\n echo \"SCOPE:${scope}\"\n echo \"BREAKING:${breaking}\"\n echo \"DESCRIPTION:${desc}\"\n echo \"BODY:${body}\"\n echo \"FOOTERS:${footers}\"\n echo \"---\"\n}\n\n# Use a delimiter unlikely to appear in commit messages\nDELIM=\"---COMMIT-BOUNDARY---\"\n\n# Exclude merge commits — release notes should reflect individual changes, not merge boundaries\n# Use process substitution (\u003c \u003c(...)) instead of a pipe so the while loop runs in the current\n# shell. This ensures the \"last commit\" fallback block can access HASH/LINES after the loop.\nwhile IFS= read -r line; do\n if [[ \"$line\" == \"$DELIM\" ]]; then\n if [[ -n \"${HASH:-}\" ]]; then\n process_commit\n fi\n\n # Reset for next commit\n unset HASH\n unset LINES\n continue\n fi\n\n if [[ -z \"${HASH:-}\" ]]; then\n HASH=\"$line\"\n LINES=()\n else\n LINES+=(\"$line\")\n fi\ndone \u003c \u003c(git log \"$RANGE\" --pretty=format:\"%H%n%B%n${DELIM}\" --no-merges)\n\n# Process last commit if no trailing delimiter\nif [[ -n \"${HASH:-}\" ]]; then\n process_commit\nfi\n","content_type":"application/x-sh; charset=utf-8","language":"bash","size":3750,"content_sha256":"9b324bbe0386c5dc1f42b22591f18175d11a7a8c8df553adf4b86650a15219e9"}],"content_json":{"type":"doc","content":[{"type":"heading","attrs":{"level":1},"content":[{"text":"Release Notes Generator","type":"text"}]},{"type":"paragraph","content":[{"text":"Generate release notes and changelogs by parsing conventional commit messages from git log history. Commits following the Conventional Commits specification (feat:, fix:, docs:, etc.) are categorized, grouped, and formatted into professional markdown output.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Workflow","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Step 1: Determine Output Type","type":"text"}]},{"type":"paragraph","content":[{"text":"Ask the user what they need:","type":"text"}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Release Notes","type":"text","marks":[{"type":"strong"}]},{"text":" — a single release summary written to ","type":"text"},{"text":"RELEASE_NOTES.md","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Changelog","type":"text","marks":[{"type":"strong"}]},{"text":" — append to an existing ","type":"text"},{"text":"CHANGELOG.md","type":"text","marks":[{"type":"code_inline"}]},{"text":" (or create one)","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Both","type":"text","marks":[{"type":"strong"}]},{"text":" — generate both files","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Step 2: Determine Commit Range","type":"text"}]},{"type":"paragraph","content":[{"text":"Identify which commits to include. Two approaches:","type":"text"}]},{"type":"paragraph","content":[{"text":"Since last tag (default):","type":"text","marks":[{"type":"strong"}]},{"text":" The parser script automatically detects the latest tag and uses ","type":"text"},{"text":"\u003ctag>..HEAD","type":"text","marks":[{"type":"code_inline"}]},{"text":" when no range is provided. To confirm the range with the user before generating, run ","type":"text"},{"text":"git describe --tags --abbrev=0","type":"text","marks":[{"type":"code_inline"}]},{"text":" to display the latest tag.","type":"text"}]},{"type":"paragraph","content":[{"text":"Custom range:","type":"text","marks":[{"type":"strong"}]},{"text":" Accept a user-specified range like ","type":"text"},{"text":"v1.0.0..v2.0.0","type":"text","marks":[{"type":"code_inline"}]},{"text":" or ","type":"text"},{"text":"v1.0.0..HEAD","type":"text","marks":[{"type":"code_inline"}]},{"text":" and pass it as the first argument to the parser script.","type":"text"}]},{"type":"paragraph","content":[{"text":"If no tags exist, ask the user for a range or default to all commits (the script handles this automatically).","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Step 3: Parse Commits","type":"text"}]},{"type":"paragraph","content":[{"text":"Run the parser script to extract structured commit data. The ","type":"text"},{"text":"${CLAUDE_PLUGIN_ROOT}","type":"text","marks":[{"type":"code_inline"}]},{"text":" variable is set automatically by Claude Code when the plugin is installed:","type":"text"}]},{"type":"code_block","attrs":{"wrap":false,"language":"bash"},"content":[{"text":"bash ${CLAUDE_PLUGIN_ROOT}/skills/generate-release-notes/scripts/parse-commits.sh [\u003crange>]","type":"text"}]},{"type":"paragraph","content":[{"text":"The script outputs one block per commit with fields: ","type":"text"},{"text":"COMMIT","type":"text","marks":[{"type":"code_inline"}]},{"text":", ","type":"text"},{"text":"TYPE","type":"text","marks":[{"type":"code_inline"}]},{"text":", ","type":"text"},{"text":"SCOPE","type":"text","marks":[{"type":"code_inline"}]},{"text":", ","type":"text"},{"text":"BREAKING","type":"text","marks":[{"type":"code_inline"}]},{"text":", ","type":"text"},{"text":"DESCRIPTION","type":"text","marks":[{"type":"code_inline"}]},{"text":", ","type":"text"},{"text":"BODY","type":"text","marks":[{"type":"code_inline"}]},{"text":", ","type":"text"},{"text":"FOOTERS","type":"text","marks":[{"type":"code_inline"}]},{"text":".","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Step 4: Categorize and Format","type":"text"}]},{"type":"paragraph","content":[{"text":"Group parsed commits by type into sections using this mapping:","type":"text"}]},{"type":"table","attrs":{"layout":null},"content":[{"type":"tr","content":[{"type":"th","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Type","type":"text"}]}]},{"type":"th","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Section Heading","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"feat","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Features","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"fix","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Bug Fixes","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"perf","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Performance Improvements","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"refactor","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Code Refactoring","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"docs","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Documentation","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"style","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Styles","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"test","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Tests","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"build","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Build System","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"ci","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Continuous Integration","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"chore","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Chores","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"revert","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Reverts","type":"text"}]}]}]}]},{"type":"paragraph","content":[{"text":"Ordering:","type":"text","marks":[{"type":"strong"}]},{"text":" List sections in the order shown above. Within each section, list entries alphabetically by scope (ungrouped entries last).","type":"text"}]},{"type":"paragraph","content":[{"text":"Breaking changes:","type":"text","marks":[{"type":"strong"}]},{"text":" Collect all commits with ","type":"text"},{"text":"BREAKING:yes","type":"text","marks":[{"type":"code_inline"}]},{"text":" into a dedicated \"BREAKING CHANGES\" section at the top, regardless of their type. These also appear in their normal type section.","type":"text"}]},{"type":"paragraph","content":[{"text":"Scope grouping:","type":"text","marks":[{"type":"strong"}]},{"text":" When multiple commits share a scope, group them under a bold scope label.","type":"text"}]},{"type":"paragraph","content":[{"text":"Commits with type \"other\":","type":"text","marks":[{"type":"strong"}]},{"text":" Collect into an \"Other Changes\" section at the bottom. These are commits that do not follow the conventional commit format.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Step 5: Determine Version","type":"text"}]},{"type":"paragraph","content":[{"text":"If the user provides a version number, use it. Otherwise, suggest a version based on SemVer rules:","type":"text"}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Any ","type":"text"},{"text":"BREAKING:yes","type":"text","marks":[{"type":"code_inline"}]},{"text":" commit → suggest MAJOR bump","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Any ","type":"text"},{"text":"feat","type":"text","marks":[{"type":"code_inline"}]},{"text":" commit → suggest MINOR bump","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Only ","type":"text"},{"text":"fix","type":"text","marks":[{"type":"code_inline"}]},{"text":", ","type":"text"},{"text":"docs","type":"text","marks":[{"type":"code_inline"}]},{"text":", ","type":"text"},{"text":"style","type":"text","marks":[{"type":"code_inline"}]},{"text":", etc. → suggest PATCH bump","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Read the latest tag to determine the current version and calculate the next version. Present the suggestion and let the user confirm or override.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Step 6: Write Output","type":"text"}]},{"type":"paragraph","content":[{"text":"Release Notes","type":"text","marks":[{"type":"strong"}]},{"text":" → Write to ","type":"text"},{"text":"RELEASE_NOTES.md","type":"text","marks":[{"type":"code_inline"}]},{"text":" (overwrite previous content).","type":"text"}]},{"type":"paragraph","content":[{"text":"Changelog","type":"text","marks":[{"type":"strong"}]},{"text":" → Prepend new version entry to ","type":"text"},{"text":"CHANGELOG.md","type":"text","marks":[{"type":"code_inline"}]},{"text":". If the file does not exist, create it with a header. Preserve all existing entries below the new one.","type":"text"}]},{"type":"paragraph","content":[{"text":"Consult ","type":"text"},{"text":"references/formats.md","type":"text","marks":[{"type":"code_inline"}]},{"text":" for the exact output templates.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Step 7: Summary","type":"text"}]},{"type":"paragraph","content":[{"text":"After writing, display:","type":"text"}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Version number used","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Number of commits processed","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Breakdown by category (e.g., \"3 features, 2 bug fixes, 1 breaking change\")","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"File(s) written","type":"text"}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Handling Edge Cases","type":"text"}]},{"type":"paragraph","content":[{"text":"No conventional commits found:","type":"text","marks":[{"type":"strong"}]},{"text":" Warn the user that no parseable commits were found. Offer to list raw commit messages instead.","type":"text"}]},{"type":"paragraph","content":[{"text":"Mixed conventional and non-conventional:","type":"text","marks":[{"type":"strong"}]},{"text":" Process conventional commits normally, list non-conventional commits under \"Other Changes.\"","type":"text"}]},{"type":"paragraph","content":[{"text":"Empty range:","type":"text","marks":[{"type":"strong"}]},{"text":" If the range produces no commits, inform the user and suggest checking the range.","type":"text"}]},{"type":"paragraph","content":[{"text":"Monorepo with scopes:","type":"text","marks":[{"type":"strong"}]},{"text":" When scopes map to packages/modules, offer to group by scope as top-level sections instead of by type.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Additional Resources","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Reference Files","type":"text"}]},{"type":"paragraph","content":[{"text":"For detailed output format templates and examples, consult:","type":"text"}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"references/formats.md","type":"text","marks":[{"type":"code_inline"},{"type":"strong"}]},{"text":" — Complete output templates for release notes and changelog, with examples of each section type","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Scripts","type":"text"}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"scripts/parse-commits.sh","type":"text","marks":[{"type":"code_inline"},{"type":"strong"}]},{"text":" — Parses git log into structured commit data. Accepts an optional range argument. Handles conventional commit parsing, scope extraction, breaking change detection, and footer parsing.","type":"text"}]}]}]}]},"metadata":{"date":"2026-11-02","name":"generate-release-notes","author":"@skillopedia","source":{"stars":4,"repo_name":"donnfelker-plugin-marketplace","origin_url":"https://github.com/donnfelker/donnfelker-plugin-marketplace/blob/HEAD/plugins/generate-release-notes/skills/generate-release-notes/SKILL.md","repo_owner":"donnfelker","body_sha256":"f3366e212b6c93858d9aeb034065bce26b17b81c53c319fc6aaa67b0a978a544","cluster_key":"e6c19d059ef652ae4474dbeb6f990e5f3ad56fefb45075009262510711fb6aff","clean_bundle":{"format":"clean-skill-bundle-v1","source":"donnfelker/donnfelker-plugin-marketplace/plugins/generate-release-notes/skills/generate-release-notes/SKILL.md","text_bytes":9745,"source_commit":"15072d7181625b3c42f0b347734ea391a6c22640","skills_sh_rank":15226,"attachment_count":2,"text_attachments":2,"attachment_storage":"skill_attachments","binary_attachments":0},"cluster_size":1,"skill_md_path":"plugins/generate-release-notes/skills/generate-release-notes/SKILL.md","import_metadata":{"date":"2026-11-02","author":"@skillopedia","version":"v1","category":"devops-infrastructure","category_label":"DevOps"},"exact_dupes_collapsed_into_this":0},"version":"v1","category":"devops-infrastructure","import_tag":"skills-sh-top20k-2026-11","description":"This skill should be used when the user asks to \"generate release notes\", \"generate changelog\", \"create release notes\", \"write changelog\", \"what changed since last release\", \"prepare release notes\", \"update changelog\", or \"summarize changes from git history\". Parses conventional commit messages to produce categorized, well-formatted release notes or changelog entries."}},"renderedAt":1793665998135}

Release Notes Generator Generate release notes and changelogs by parsing conventional commit messages from git log history. Commits following the Conventional Commits specification (feat:, fix:, docs:, etc.) are categorized, grouped, and formatted into professional markdown output. Workflow Step 1: Determine Output Type Ask the user what they need: - Release Notes — a single release summary written to - Changelog — append to an existing (or create one) - Both — generate both files Step 2: Determine Commit Range Identify which commits to include. Two approaches: Since last tag (default): The p…