name	changelog-append
description	The user invokes `/changelog-append` to record a change just made (bug fix, feature, etc.) as a concise changelog entry. It appends one raw line under the right component group + subcategory of the top (latest) version block in `docs/changelog.yml`, then runs `./compile_readme.py` to regenerate `README.md`. Invoke when the user types `/changelog-append` or asks to add a changelog entry.

changelog-append - record one change in the changelog

The user invoked /changelog-append. Add one concise entry for the change just made, then regenerate the README.

User-invoked only. Only the user triggers this skill by typing /changelog-append. An agent never invokes it on its own initiative - finishing a change is not a license to write the changelog.

Procedure

docs/changelog.yml is the source; the README table and the website changelog page are generated from it.

Open docs/changelog.yml. The latest version is the topmost list entry (currently TBA at the top).
Pick the group + subcategory from the legend above. If that group: / subcat: key already exists in the top entry, append your line to its | block; otherwise add the key (a | literal block) in any order. Do not create a new version entry. Do not touch older entries.
Write one raw line. Plain string - no escaping; colons and <, &, quotes are fine. **text** renders bold. Strip a prefix that just repeats the group (Guest Additions:, Launcher:), but keep a board name that says which device (NEC MP700:, Zune 30:).
Run python compile_readme.py (from repo root). Confirm it prints README.md compiled (vX.Y).

Writing the entry

A changelog line, not narration. State what changed to the product, in the fewest words that are still clear. Smaller is better.
One line per change. If the work spans clearly separate user-visible changes, add one line each - but do not pad; prefer a single tight line.
No conversation echoes, no session history, no model/agent references, no "as you asked".

Example top entry after adding a device fix and a guest-additions feature:

- version: v6.6
  date: TBA
  devices:
    fixed: |
      Fixed Device Emulator crash booting Windows Mobile 5.2 ROMs
  guest_additions:
    new: |
      Clipboard sharing with the host

Git

Do not run any git command unless the user explicitly asks (e.g. "stage your changes", "commit"). When they do, the changelog edit and the regenerated README.md are both part of the changeset - include both.

changelog-append - record one change in the changelog

The user invoked /changelog-append. Add one concise entry for the change just made, then regenerate the README.

User-invoked only. Only the user triggers this skill by typing /changelog-append. An agent never invokes it on its own initiative - finishing a change is not a license to write the changelog.

changelog-append