← Catalog

No. 126 · writing

Changelog Writing

Changelogs that users actually read

Version 1.0.0 License MIT Format SKILL.md

Write useful changelogs: categorize changes, write clear descriptions, highlight breaking changes, and maintain a consistent format that users can scan.

When to use this skill

  • Writing a changelog entry
  • Documenting breaking changes
  • Creating release notes

Core concepts

This skill provides guidance on changelog writing best practices, patterns, and common pitfalls. It is designed to be loaded on demand when a relevant task is detected.

Installation

curl -LO https://opencode-skills.example/downloads/writing/changelog-writing.zip
unzip changelog-writing.zip -d ~/.config/opencode/skills/

Restart OpenCode — the skill loads automatically.

When it triggers

  • writing a changelog entry
  • documenting breaking changes
  • creating release notes