About

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

Use it

Copy one of these into your project. Installing also returns the manifest and these snippets.

yaml

targets:
  - https://api.opensmartroute.ai/api/v1/registry/jeremylongshore-tons-of-skills-marketplace-changelog-orc-fc0e74/manifest   # or paste the manifest below

Manifest

An Open Capability Manifest: the router reads it to know what this does, what it costs and when to pick it.

jeremylongshore-tons-of-skills-marketplace-changelog-orc-fc0e74.ocm.jsonjson

{
  "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
  }
}

Fetch it by URL: GET /api/v1/registry/jeremylongshore-tons-of-skills-marketplace-changelog-orc-fc0e74/manifest?version=1.0.0

Reviews

Star ratings from people who tried it. One review per account; edit yours any time.

No reviews yet. Install it, try it, and be the first to rate it.