# Changelog Release Notes

Maintain Con's CHANGELOG.md and release notes.

- Repository: https://github.com/nowledge-co/con-terminal (651 stars)
- Category: Git and review
- License: MIT
- Last updated: 2026-11-01
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add nowledge-co/con-terminal --skill changelog-release-notes -g -a claude-code -y`
Codex: `npx skills add nowledge-co/con-terminal --skill changelog-release-notes -g -a codex -y`
Cursor: `npx skills add nowledge-co/con-terminal --skill changelog-release-notes -g -a cursor -y`
Gemini CLI: `npx skills add nowledge-co/con-terminal --skill changelog-release-notes -g -a gemini-cli -y`

## Description

Maintain Con's CHANGELOG.md and release notes. Use when updating changelog entries, preparing a beta/dev release, reviewing PR release-note coverage, or ensuring contributor PR credit is present.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# Changelog Release Notes

Use this skill whenever `CHANGELOG.md`, PR release notes, or release summaries
are touched.

## Workflow

1. Verify the latest released beta before choosing a heading:
   - `git fetch --tags origin`
   - `git tag --sort=-v:refname | rg '^v[0-9]+\\.[0-9]+\\.[0-9]+-beta\\.' | head`
   - `gh release view <tag>` when GitHub release state matters
2. Put pending work under the next unreleased beta only. If the latest shipped
   beta is `v0.1.0-beta.63`, the top unreleased heading is
   `v0.1.0-beta.64`; do not create `beta.65` until `beta.64` is tagged and
   released.
3. Gather PR and author context for every entry:
   - `gh pr view <number> --json number,title,author,url,mergedAt`
   - for merged work, `git log <latest-tag>..HEAD --merges --oneline` helps
     find the included PRs
4. Every PR-derived changelog bullet must end with PR and author credit:
   - `_(PR [#149](https://github.com/nowledge-co/con-terminal/pull/149) by [@sundy-li](https://github.com/sundy-li))_`
5. Credit contributors exactly by GitHub login. Preserve external contributor
   credit even when follow-up commits refine the same feature.
6. Keep shipped historical sections stable. Only edit old sections to correct a
   factual mistake, missing credit, or broken link.

## Writing Rules

The rest: https://github.com/nowledge-co/con-terminal/blob/HEAD/skills/changelog-release-notes/SKILL.md
