changelog-writer

Solid

Write external-facing changelog and release note entries in a pithy, tastefully sassy, occasionally clever voice that makes software updates fun to read without burying what actually shipped. Use this skill whenever someone asks to write, draft, or review a changelog entry, release notes, "what's new" post, or product update announcement for end users. Also trigger when someone pastes a list of shipped features/fixes and wants them turned into public-facing copy, or asks to make a changelog "less boring," "more fun," or "not sound like corporate speak."

Web & Frontend 21 stars 0 forks Updated 4 days ago MIT

Install

View on GitHub

Quality Score: 82/100

Stars 20%
45
Recency 20%
100
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
80
License 10%
100
Description 5%
100

Skill Content

# Changelog Writer Writes external, end-user-facing changelog entries with personality — modeled on what Slack, Basecamp, Linear, Raycast, and Tumblr do well: voice and confidence first, jokes used sparingly and only in service of the fact, never replacing it. **This skill is for external/end-user changelogs.** If the audience is internal engineering or the changelog needs to double as a searchable technical record (breaking changes, API versioning, migration notes), this tone is the wrong trade — use a precise, Stripe-style format instead and skip this skill. **Reference files:** - `references/voice-examples.md` — annotated examples of the tone done well (Slack, Basecamp, Tumblr, Raycast, Linear) and done badly, for calibration - `references/draft-format.md` — the full spec for the intermediate draft format the scripts parse **Scripts** (in `scripts/`) — run these against every draft before presenting a final version: - `check-all.mjs` — runs everything below and gives one pass/fail report - `check-structure.mjs`, `check-sass-budget.mjs`, `check-voice.mjs`, `check-length.mjs`, `check-cadence.mjs` --- ## Workflow 1. **Gather the raw material.** Get the list of what actually shipped — feature names, what changed, any tickets/PRs. If it's vague ("we improved search"), ask what specifically changed before writing anything. A joke can't rescue an entry with no real content behind it. 2. **Group by theme, not by ticket.** Five related tweaks become one entry. Assign...

Details

Author
ommakes
Repository
ommakes/Skills
Created
4 months ago
Last Updated
4 days ago
Language
JavaScript
License
MIT

Similar Skills

Semantically similar based on skill content — not just same category