# Rust Xpra Feature Changelog

> Generate or update rust-xpra CHANGELOG.md release entries from Git history. Use when asked to list features added since a release, include changes from intermediate patch releases, classify entries under the existing platform/network/encoding/feature headings, link entries to commits, and exclude fixes, refactoring, cleanup, and log-only changes.

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

---


# Rust Xpra Feature Changelog

Generate concise, feature-only release notes from commits after a requested base release.

## Workflow

1. Read `CHANGELOG.md`, inspect `git status --short`, and preserve unrelated worktree changes.
2. Resolve the requested release to the actual tag. Account for version/tag differences such as release `0.2.0` being tagged `v0.2`.
3. Use every commit reachable from the base tag through `HEAD`. If an intermediate release such as `0.2.1` has no tag, do not omit its changes; the full `BASE..HEAD` range already includes them.
4. Inspect commit subjects, bodies, stats, and relevant diffs. Use README or capability changes as supporting evidence. Do not classify from subjects alone.
5. Include commits that add a capability users, servers, packagers, or supported environments can use, including:
   - protocol, authentication, compression, or remote-integration support;
   - image/video encoding support;
   - window, cursor, notification, bell, desktop, or other client behavior;
   - new platform, build, linking, or packaging options.
6. Exclude:
   - bug fixes and corrections to existing behavior;
   - graceful failure or error-handling changes;
   - resource cleanup and decoder lifecycle fixes;
   - refactoring, file moves, helper extraction, and code cleanup;
   - warning-level, formatting, diagnostic, or debug-log-only changes.
7. Preserve the current release heading, category names, emoji, indentation, and wording style. Do not change the release version or date unless requested.
8. Write each entry as a short imperative capability description with a full commit link:

   ```markdown
   * 🖧 Network:
     * [send `ping` packets](https://github.com/Xpra-org/rust-xpra/commit/FULL_HASH)
   ```

9. Put entries under the most specific existing category:
   - `🔧 Platforms, build and packaging`
   - `🖧 Network`
   - `🌈 Encodings`
   - `✨ Features`
10. Reuse a commit in more than one category only when it delivers genuinely distinct facets, such as an encoding plus a packaging/linking option.
11. Leave excluded commits out of `CHANGELOG.md`; do not add a fixes or refactoring section.

## Validation

1. Compare the final entries with the complete `BASE..HEAD` commit list and confirm every included commit is a feature.
2. Verify every linked full hash resolves to a commit.
3. Run:

   ```bash
   git diff --check -- CHANGELOG.md
   git diff -- CHANGELOG.md
   ```

4. Confirm only `CHANGELOG.md` and intentional skill files changed during this task.