changelog-writing SKILL.md skillA

changelog-writing from samber/developer-relations-skills is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add samber/developer-relations-skills/changelog-writing@v1.0.4

Pins v1.0.4 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
samber/developer-relations-skills
Path
skills/changelog-writing/SKILL.md
Versions recorded
7
Latest version
v1.0.4, committed Oct 25, 2026
First version recorded
Sep 27, 2026
Size
25,718 bytes
Repository stars
8
License
MIT

Turns raw commits, pull requests and tickets into release notes developers actually read - a scannable record of what shipped, what it means in practice, and what breaks. Use whenever the user mentions a changelog, CHANGELOG.md, release notes, a GitHub release body for a tag, a hosted "what's new" page, app-store release notes, Keep a Changelog, or Common Changelog, or asks what to write for a release they just cut - even when the commit history is messy and follows no commit convention.…

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# Changelog Writing

You are a release-communication specialist. Take the raw record of what shipped - commits, merged pull requests, issues, tickets - and produce release notes a developer can scan in fifteen seconds to answer one question: _does this release cost me work?_

A generator produces a list. Produce the editorial layer no generator does: what to keep, what it means for a reader, and what breaks. That layer is why the task is expensive and disliked - drafting one release-note document takes an experienced developer up to 8 hours (Moreno et al., as cited in Daneshyan et al., FSE 2025), and a Microsoft developer advocate summarized the sentiment: "we hate creating release notes when it's our turn to ship" (Jasmine Greenaway, opensource.microsoft.com, 2018).

## Scope check

Confirm the task before starting. Route elsewhere when:

- The user wants versions bumped, tags cut, or artefacts published → release-automation tooling, not this skill.
- The change needs before/after code, a deprecation timeline, and codemods → `samber/developer-relations-skills@version-migration-guide`.
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add samber/developer-relations-skills/changelog-writing@sha256:d672397c0fb05e7d

The line at the top of this page pins the label v1.0.4, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_fmfzpljqmo3rwcav.svg)](https://markdownregistry.com/a/art_fmfzpljqmo3rwcav)

2 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 7 versions of this file, between Sep 27, 2026 and Oct 25, 2026, about one every 5 days.

versioncommittedcommitsizeaudit
v1.0.4 latest2026-10-25 2c2141c 25,718 BA view · diff
v1.0.32026-10-25 21c129d 25,706 BA view · diff
v1.0.32026-10-24 c0cdfbe 25,490 BA view · diff
v1.0.12026-10-21 3594864 25,347 BA view · diff
v1.0.22026-10-21 79ebb7b 25,347 BA view · diff
v1.0.12026-10-21 17e924b 25,172 BA view · diff
v1.0.12026-09-27 bc8ac6d 25,016 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (25718 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

samber/developer-relations-skills · 8 stars · license MIT · pushed 2026-11-01 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_fmfzpljqmo3rwcav
GET https://markdownregistry.com/api/v1/resolve?ref=samber/developer-relations-skills/changelog-writing
GET https://markdownregistry.com/api/v1/blob/d672397c0fb05e7d12b369419c094e246caec2f7374f2519f6322f9f158df422

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from samber/developer-relations-skills

bluesky-dev-playbook SKILL.md skill
samber/developer-relations-skills · skills/bluesky-dev-playbook/SKILL.md · Runs a devtool vendor's, developer advocate's or open-source maintainer's presence on Bluesky - go-or-skip verdict…
v1.0.0 · audit A · 8 stars
build-in-public SKILL.md skill
samber/developer-relations-skills · skills/build-in-public/SKILL.md · Designs a sustainable build-in-public practice for an open-source project or developer tool: how far up the disclosure…
v1.0.5 · audit A · 8 stars
coding-agent-docs-optimization SKILL.md skill
samber/developer-relations-skills · skills/coding-agent-docs-optimization/SKILL.md · Makes SDK, API or protocol documentation something a coding agent can integrate from unattended - crawler access…
v1.0.3 · audit A · 8 stars
conference-cfp-submission SKILL.md skill
samber/developer-relations-skills · skills/conference-cfp-submission/SKILL.md · Turns a talk idea into a submission-ready conference proposal for one specific event, or helps choose which conferences…
v1.0.2 · audit A · 8 stars
dailydev-playbook SKILL.md skill
samber/developer-relations-skills · skills/dailydev-playbook/SKILL.md · Runs a devtool vendor's or maintainer's presence on daily.dev - entry path (indexed source, New Post, own Squad…
v1.0.0 · audit A · 8 stars
developer-booth-playbook SKILL.md skill
samber/developer-relations-skills · skills/developer-booth-playbook/SKILL.md · Writes an exhibiting company's own playbook for an in-person booth at a developer conference: who works it and how many…
v1.0.0 · audit A · 8 stars
developer-case-study SKILL.md skill
samber/developer-relations-skills · skills/developer-case-study/SKILL.md · Turns a customer's real production deployment into a technical case study engineers believe - measured numbers tied…
v1.0.2 · audit A · 8 stars
developer-certification-program SKILL.md skill
samber/developer-relations-skills · skills/developer-certification-program/SKILL.md · Plans the issuer side of a developer certification or badge program, mostly for freelancers and IT services firms who…
v1.0.2 · audit A · 8 stars
developer-champions SKILL.md skill
samber/developer-relations-skills · skills/developer-champions/SKILL.md · Designs an unpaid, perks-only developer champions or ambassador program end to end - readiness check, intake model…
v1.0.1 · audit A · 8 stars
developer-community-health SKILL.md skill
samber/developer-relations-skills · skills/developer-community-health/SKILL.md · Designs and runs a developer community health measurement framework: activity, responsiveness, contributor-funnel and…
v1.0.1 · audit A · 8 stars
developer-community-launch SKILL.md skill
samber/developer-relations-skills · skills/developer-community-launch/SKILL.md · Decides whether, where and when to launch a developer community, then plans its seeding and first 90 days - venue…
v1.0.1 · audit A · 8 stars
developer-community-moderation SKILL.md skill
samber/developer-relations-skills · skills/developer-community-moderation/SKILL.md · Writes a developer community's code of conduct and the moderation playbook behind it - scope, enforcement ladder…
v1.0.1 · audit A · 8 stars

Every file in samber/developer-relations-skills

Browse by kind, by grade A, or by owner.