Imported from jeremylongshore/tons-of-skills-marketplace (plugins/devops/mattyp-changelog/skills/changelog-orchestrator/SKILL.md). Install upstream with npx skills add jeremylongshore/tons-of-skills-marketplace --skill changelog-orchestrator. Copyright stays with the author (MIT).

Changelog Orchestrator

Name: changelog-orchestrator
Author: jeremylongshore

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

{ "ocm": "1", "id": "jeremylongshore-tons-of-skills-marketplace-changelog-orc-fc0e74", "kind": "skill", "name": "changelog-orchestrator", "description": "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\".", "publisher": "jeremylongshore", "version": "1.0.0", "capabilities": { "domains": [ "coding" ], "tags": [ "skill-md", "automation", "changelog-orchestrator", "skills-sh" ], "languages": [ "en" ] }, "quality_prior": 0.6, "examples": [ "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\"." ], "primary": false, "metadata": { "source": { "provider": "skills.sh", "repository": "https://github.com/jeremylongshore/tons-of-skills-marketplace", "path": "plugins/devops/mattyp-changelog/skills/changelog-orchestrator/SKILL.md", "ref": "HEAD", "url": "https://github.com/jeremylongshore/tons-of-skills-marketplace/blob/HEAD/plugins/devops/mattyp-changelog/skills/changelog-orchestrator/SKILL.md", "key": "jeremylongshore/tons-of-skills-marketplace/plugins/devops/mattyp-changelog/skills/changelog-orchestrator/SKILL.md" }, "compatibility": "Designed for Claude Code", "allowed_tools": [ "Read,", "Write,", "Edit,", "Grep,", "Glob,", "Bash(git:*),", "Bash(gh:*),", "Bash(python:*),", "Bash(date:*)" ], "license": "MIT" }, "instructions": "# Changelog Orchestrator\n\n## Overview\n\nThis skill turns raw repo activity (merged PRs, issues, commits, optional Slack updates) into a publishable changelog draft and prepares a branch/PR for review.\n\n## Prerequisites\n\n- A project config file at `.changelog-config.json` in the target repo.\n- Required environment variables set (at minimum `GITHUB_TOKEN` for GitHub source).\n- Git available in PATH; `gh` optional (used for PR creation if configured).\n\n## Instructions\n\n1. Read `.changelog-config.json` from the repo root.\n2. Validate it with `${CLAUDE_SKILL_DIR}/scripts/validate_config.py`.\n3. Deci", "cost": { "context_tokens": 533 } }

changelog-orchestrator

About