Skill

changelog-orchestrator

Drafts changelog PRs from GitHub/Slack/Git changes, formats with templates, runs quality gates, and creates review branches/PRs for weekly/monthly release notes.

Git

Github

Python

documentation

automation

npx claudepluginhub jeremylongshore/claude-code-plugins-plus-skills

Tool Access

This skill is limited to using the following tools:

ReadWriteEditGrepGlobBash(git:*)Bash(gh:*)Bash(python:*)Bash(date:*)

Preview

This skill turns raw repo activity (merged PRs, issues, commits, optional Slack updates) into a publishable changelog draft and prepares a branch/PR for review.

Supporting Assets

assets/default-changelog.mdassets/release-template.mdassets/weekly-template.mdreferences/errors.mdreferences/examples.mdreferences/implementation.mdscripts/quality_score.pyscripts/render_template.pyscripts/validate_config.py

SKILL.md

Similar Skills

changelog-automation

36.4k

Automates changelog generation from commits, PRs, and releases following Keep a Changelog format. Use for release workflows, release notes, and commit conventions.

1 file

antigravity-awesome-skills

changelog-automation

682

Automates changelog generation from commits, PRs, and releases following Keep a Changelog format. Useful for release workflows, generating release notes, and standardizing commit conventions.

1 file

rmyndharis-antigravity-skills

changelog-composer

221

Generates structured changelogs and release notes from git history and PRs, classifying breaking changes, features, fixes, performance, docs using conventional commits.

5 files

armory

Stats

Parent Repo Stars1854

Parent Repo Forks248

Last CommitApr 3, 2026

Actions

View Source View Plugin View on GitHub View README

Help us improve

Share bugs, ideas, or general feedback.

Changelog Orchestrator

Overview

This skill turns raw repo activity (merged PRs, issues, commits, optional Slack updates) into a publishable changelog draft and prepares a branch/PR for review.

Prerequisites

A project config file at .changelog-config.json in the target repo.

Required environment variables set (at minimum GITHUB_TOKEN for GitHub source).

Git available in PATH; gh optional (used for PR creation if configured).

Instructions

Read .changelog-config.json from the repo root.

Validate it with ${CLAUDE_SKILL_DIR}/scripts/validate_config.py.

Decide date range:

Load the configured markdown template (or fall back to ${CLAUDE_SKILL_DIR}/assets/weekly-template.md).

Render the final markdown using ${CLAUDE_SKILL_DIR}/scripts/render_template.py.

Ensure frontmatter contains at least date (ISO) and version (SemVer if known; otherwise 0.0.0).

Run deterministic checks using ${CLAUDE_SKILL_DIR}/scripts/quality_score.py.

If score is below threshold:

Write the changelog file to the configured output_path.

Create a branch changelog-YYYY-MM-DD, commit with docs: add changelog for YYYY-MM-DD.

If gh is configured, open a PR; otherwise, print the exact commands the user should run.

See ${CLAUDE_SKILL_DIR}/references/implementation.md for detailed implementation guide.

Output

A markdown changelog draft (usually CHANGELOG.md), plus an optional PR URL.

A quality report (score + findings) from ${CLAUDE_SKILL_DIR}/scripts/quality_score.py.

Error Handling

See ${CLAUDE_SKILL_DIR}/references/errors.md for comprehensive error handling.

Examples

See ${CLAUDE_SKILL_DIR}/references/examples.md for detailed examples.

Resources

Validate config: ${CLAUDE_SKILL_DIR}/scripts/validate_config.py

Render template: ${CLAUDE_SKILL_DIR}/scripts/render_template.py

Quality scoring: ${CLAUDE_SKILL_DIR}/scripts/quality_score.py

Default templates:

${CLAUDE_SKILL_DIR}/assets/default-changelog.md
${CLAUDE_SKILL_DIR}/assets/weekly-template.md
${CLAUDE_SKILL_DIR}/assets/release-template.md