# Changelog

> Use when generating a changelog from recent merged PRs or documenting releases. Triggers on "write changelog", "release notes", "what shipped".

- Skill: `tomevault-io/changelog-3` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/changelog-3`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/changelog-3/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/changelog-3

---


# Write Changelog

Generate a changelog for recent changes by reviewing merged PRs since the last changelog.

## Usage

```
/changelog
```

## What It Does

1. **Finds Latest Changelog**
   - Checks your changelog directory (e.g., `docs/internal/changelog/` or `$CHANGELOG_DIR`)
   - Identifies most recent changelog by date in filename

2. **Fetches Recent PRs**
   - Uses GitHub API to get all PRs merged to main since last changelog
   - Extracts PR titles, descriptions, and metadata

3. **Generates New Changelog**
   - Creates markdown file with date in filename
   - Formats according to project conventions

## Changelog Format

The changelog follows this structure:

- **1-3 Most Impactful Changes** (heading 2 each)
  - Title: 1-3 words describing the change
  - Description: 1-2 sentences explaining the change
  - Placeholder for visual (screenshot/diagram)

- **Summary of Smaller Changes** (if applicable)
  - High-level bullets for minor updates

## Focus

- **User-facing changes** and new features
- **Breaking changes** highlighted prominently
- **Major bug fixes** and improvements
- Skip internal refactors unless significant

## Example Structure

```markdown
# Changelog - 2026-01-07

## Advanced Filtering

Added support for complex filter expressions in the query interface. Users can now combine multiple conditions using AND/OR operators and apply filters across related tables.

[Placeholder for screenshot]

## Performance Boost

Optimized query execution engine reduces average query time by 60% for large datasets through intelligent caching and parallel processing.

[Placeholder for screenshot]

## Additional Updates

- Fixed authentication timeout issues in Safari
- Improved error messages for failed data source connections
- Updated UI styling for better accessibility
```

## Notes

- Requires GitHub CLI (`gh`) to be installed and authenticated
- Changelog saved to your changelog directory (e.g., `docs/internal/changelog/YYYY-MM-DD.md`)
- Focuses on user impact, not technical implementation details

---
> Converted and distributed by [TomeVault](https://tomevault.io/claim/v1-io) — claim your Tome and manage your conversions.
<!-- tomevault:4.0:skill_md:2026-04-13 -->