# Write Changelog

> Write or update changelog entries with user-focused language

- Skill: `jamiebrynes7/write-changelog` (Agent Skill)
- Install (CLI): `npx skillmds@latest add jamiebrynes7/write-changelog`
- Raw SKILL.md: https://api.skillmd.com/api/skills/jamiebrynes7/write-changelog/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: jamiebrynes7 (https://skillmd.com/u/jamiebrynes7)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/jamiebrynes7/write-changelog

---


# Changelog

Write or update changelog entries following these guidelines:

## Guidelines

- **Focus on user benefits** rather than implementation details
- **Keep entries concise** - typically a single line without subpoints
- **Emphasize what the user can now do** or how their experience improves
- **Avoid technical specifics** like state management, CSS classes, or internal architecture

## Categories

Entries are organized under these category headings:

- `### ✨ Features` - New functionality for users
- `### 🐛 Bug Fixes` - Corrections to existing behavior
- `### 🔁 Changes` - Modifications to existing features
- `### ⚙ Internal` - Technical changes (use sparingly, still user-focused)
- `### 🌐 Translations` - New or updated translations
- `### Breaking changes` - For major releases only
- `### Deprecated` - Features being phased out

## Unreleased Section

Always add new entries to the `## Unreleased` section at the top of the changelog. Create the appropriate category heading if it doesn't exist yet. Entries are moved to a versioned section during the release process.

## Examples

Good:

- "Added keyboard shortcuts for common actions"
- "Tasks now sync automatically when Obsidian starts"
- "Fixed tasks not appearing after editing"

Bad:

- "Refactored TaskStore to use Redux pattern with selectors"
- "Added `useEffect` hook to trigger sync on mount"
- "Fixed CSS specificity issue in task-list component"

## Location

The changelog is located at `docs/docs/changelog.md`.