Marketing-skills changelog-page-generator

When the user wants to create, optimize, or structure a changelog or release notes page. Also use when the user mentions "changelog," "release notes," "what's new," "updates," "product updates," "version history," or "changelog.yourdomain.com." For sitewide page planning, use website-structure.

install
source · Clone the upstream repo
git clone https://github.com/kostja94/marketing-skills
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/kostja94/marketing-skills "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/pages/utility/changelog" ~/.claude/skills/kostja94-marketing-skills-changelog-page-generator && rm -rf "$T"
manifest: skills/pages/utility/changelog/SKILL.md
source content

Pages: Changelog

Guides changelog and release notes pages. Typically at

changelog.*
subdomain or
/changelog
. Builds trust, reduces support, increases feature adoption.

When invoking: On first use, if helpful, open with 1–2 sentences on what this skill covers and why it matters, then provide the main output. On subsequent use or when the user asks to skip, go directly to the main output.

Initial Assessment

Check for project context first: If

.claude/project-context.md
or
.cursor/project-context.md
exists, read it for product and release cadence.

Identify:

  1. Product type: SaaS, API, mobile app, etc.
  2. Audience: End users, developers, both
  3. Release cadence: Weekly, monthly, continuous
  4. Format: Timeline, version-based, category (New, Improved, Fixed)

Changelog Structure

SectionPurpose
EntryDate, version, title
CategoryNew, Improved, Fixed, Deprecated (optional)
DescriptionWhat changed, why it matters
LinkTo docs, blog, or in-app
MediaScreenshots, GIFs, videos (optional)

Best Practices

Content

  • User benefit first: "You can now X" not "We added X"
  • Concrete: Specific features, not vague "improvements"
  • Scannable: Headlines, bullets, tags
  • Searchable: If many entries, add search/filter

Organization

  • Reverse chronological: Newest first
  • Grouping: By version or date range
  • Tags: Feature area, product module (optional)
  • RSS/email: Notify subscribers of updates

Placement

  • Subdomain: changelog.yourdomain.com
  • Path: /changelog, /updates, /releases
  • Embed: Widget in app or docs sidebar
  • Link from: Footer, docs, in-app

Output Format

  • Structure (layout, entry format)
  • Entry template (fields, tone)
  • Navigation (filters, search)
  • SEO (index, metadata)
  • Integration (embed, RSS, email)

Related Skills

  • docs-page-generator: Changelog linked from docs
  • docs-page-generator: API changelog for developers; docs includes API Reference
  • blog-page-generator: Major releases may have blog posts
  • top-banner-generator: Announce major updates on main site