# V1 Changelog

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

- **Type:** Skill
- **Install:** `agentstack add skill-v1-io-v1tamins-v1-changelog`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [v1-io](https://agentstack.voostack.com/s/v1-io)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [v1-io](https://github.com/v1-io)
- **Source:** https://github.com/v1-io/v1tamins/tree/main/plugins/v1tamins/skills/v1-changelog

## Install

```sh
agentstack add skill-v1-io-v1tamins-v1-changelog
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Write Changelog

Generate a changelog for recent changes by reviewing merged PRs since the last changelog. This skill *generates* release notes; to sync existing docs (README, AGENTS.md, guides) with what shipped, use `v1-docs-freshness`.

## Usage

Typical invocations:
- Claude Code: `/v1-changelog`
- Codex: invoke `v1-changelog` from the skills menu or use `$v1-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

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [v1-io](https://github.com/v1-io)
- **Source:** [v1-io/v1tamins](https://github.com/v1-io/v1tamins)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-v1-io-v1tamins-v1-changelog
- Seller: https://agentstack.voostack.com/s/v1-io
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.