Claude-skill-registry 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/majiayu000/claude-skill-registry
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/majiayu000/claude-skill-registry "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/data/changelog-orchestrator" ~/.claude/skills/majiayu000-claude-skill-registry-changelog-orchestrator && rm -rf "$T"
manifest:
skills/data/changelog-orchestrator/SKILL.mdsource content
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
in the target repo..changelog-config.json - Required environment variables set (at minimum
for GitHub source).GITHUB_TOKEN - Git available in PATH;
optional (used for PR creation if configured).gh
Instructions
- Read
from the repo root..changelog-config.json - Validate it with
.{baseDir}/scripts/validate_config.py - Decide date range:
- Load the configured markdown template (or fall back to
).{baseDir}/assets/weekly-template.md - Render the final markdown using
.{baseDir}/scripts/render_template.py - Ensure frontmatter contains at least
(ISO) anddate
(SemVer if known; otherwiseversion
).0.0.0 - Run deterministic checks using
.{baseDir}/scripts/quality_score.py - If score is below threshold:
- Write the changelog file to the configured
.output_path - Create a branch
, commit withchangelog-YYYY-MM-DD
.docs: add changelog for YYYY-MM-DD - If
is configured, open a PR; otherwise, print the exact commands the user should run.gh
See
{baseDir}/references/implementation.md for detailed implementation guide.
Output
- A markdown changelog draft (usually
), plus an optional PR URL.CHANGELOG.md - A quality report (score + findings) from
.{baseDir}/scripts/quality_score.py
Error Handling
See
{baseDir}/references/errors.md for comprehensive error handling.
Examples
See
{baseDir}/references/examples.md for detailed examples.
Resources
- Validate config:
{baseDir}/scripts/validate_config.py - Render template:
{baseDir}/scripts/render_template.py - Quality scoring:
{baseDir}/scripts/quality_score.py - Default templates:
{baseDir}/assets/default-changelog.md{baseDir}/assets/weekly-template.md{baseDir}/assets/release-template.md