Skillshub changelog-orchestrator

Draft changelog PRs by collecting GitHub/Slack/Git changes, formatting with templates, running quality gates, and preparing a branch/PR. Use when generating weekly/monthly release notes or when the user asks to create a changelog from recent merges. Trigger with "changelog weekly", "generate release notes", "draft changelog", "create changelog PR".

install

source · Clone the upstream repo

git clone https://github.com/ComeOnOliver/skillshub

Claude Code · Install into ~/.claude/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/ComeOnOliver/skillshub "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/jeremylongshore/claude-code-plugins-plus-skills/changelog-orchestrator" ~/.claude/skills/comeonoliver-skillshub-changelog-orchestrator && rm -rf "$T"

manifest: skills/jeremylongshore/claude-code-plugins-plus-skills/changelog-orchestrator/SKILL.md

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