Agent-Skills.md

Agent Skills: Write Changelog

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

UncategorizedID: v1-io/v1tamins/changelog

Repository

v1-io/v1tamins
v1-ioLicense: MIT
32

Install this agent skill to your local

pnpm dlx add-skill https://github.com/v1-io/v1tamins/tree/HEAD/claude/skills/changelog

Skill Files

Browse the full folder contents for changelog.

Download Skill

Loading file tree…

claude/skills/changelog/SKILL.md

Skill Metadata

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

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

# 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