Agent skill · writing content · jeremylongshore
changelog-orchestrator
Draft changelog PRs by collecting GitHub/Slack/Git changes, formatting
Why this skill is useful
Adds a structured automation workflow for generating changelogs from repository activity that the AI wouldn't reliably generate on its own.
What it needs
Requires gh, git installed locally. Requires github account access. About 1k tokens when loaded. Last updated 2026-08-07. 2,604 stars on the source repository.
What this skill does
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 GITHUBTOKEN for GitHub source). Git available in PATH; gh optional (used for PR creation if configured). Instructions 1. Read .changelog-config.json from the repo root. 2. Validate it with ${CLAUDESKILLDIR}/scripts/validateconfig.py. 3. Decide date range: 4. Load the configured markdown template (or fall back to ${CLAUDESKILLDIR}/assets/weekly-template.md). 5. Render the final markdown using ${CLAUDESKILLDIR}/scripts/rendertemplate.py. 6. Ensure frontmatter contains at least date (ISO) and version (SemVer if known; otherwise 0.0.0). 7. Run deterministic checks using ${CLAUDESKILLDIR}/scripts/qualityscore.py. 8. If score is below threshold: 9. Write the changelog file to the configured outputpath. 10. Create a branch changelog-YYYY-MM-DD, commit with docs: add changelog for YYYY-MM-DD. 11. If gh is configured, open a PR; otherwise, print the exact commands the user should run. See ${CLAUDESKILLDIR}/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 ${CLAUDESKILLDIR}/scripts/qualityscore.py. Error Handling See ${CLAUDESKILLDIR}/references/errors.md for comprehensive error handling. Examples See ${CLAUDESKILLDIR}/references/examples.md for detailed examples. Resources Validate config: ${CLAUDESKILLDIR}/scripts/validateconfig.py Render template: ${CLAUDESKILLDIR}/scripts/rendertemplate.py Quality scoring: ${CLAUDESKILLDIR}/scripts/qualityscore.py Default templates: ${CLAUDESKILLDIR}/assets/default-changelog.md ${CLAUDESKILLDIR}/assets/weekly-template.md ${CLAUDESKILLDIR}/assets/release-template.md
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills jeremylongshore/changelog-orchestrator--b884fb