# Release > Release a new version of the project - Skill: `kh4f/release` (Agent Skill) - Install (CLI): `npx skillmds@latest add kh4f/release` - Raw SKILL.md: https://api.skillmd.com/api/skills/kh4f/release/raw - Safety review: pending - Works with: Claude Code, Claude.ai, OpenAI Codex - Category: Coding & Dev Tools - Author: kh4f (https://skillmd.com/u/kh4f) - Updated: 2026-09-17 - Page: https://skillmd.com/skills/kh4f/release --- ## Workflow 1. **Analyze Commits & Bump Version** - Retrieve commits since the latest version tag - Determine the next semantic version - Bump it in all relevant manifests 2. **Generate Changelog** - Keep only user-facing changes - Write a polished entry following the [Changelog Guidelines](#changelog-guidelines) and prepend it to `CHANGELOG.md` 3. **Review** - Ask the user for edits or to proceed - If the user requests edits, apply them and ask again 4. **Commit & Tag** - On confirmation, run: - `git add -A` - `git commit -m "chore(release): "` - `git tag -m ""` ## Changelog Guidelines ### Template ```markdown ##   ` 🏷️ v ` ###   - ****: . [🡥]() [#]() #####    [Commit log](/compare/...)  •  ``` - Group changes by category: - `📢 BREAKING CHANGES` - `✨ Features` - `🩹 Fixes` - `⚡ Performance` - `📋 Docs` - `🎨 Style` - `📦 Distribution` - If there is no previous tag (i.e. this is the first release), use `/commits/` for the commit log link. ### Examples ```markdown ##   ` 🏷️ v3.2.3 ` ###   ✨ Features - **Auto-scrolling during drag**: the explorer now scrolls automatically when dragging items near the edges. [🡥](https://github.com/kh4f/manual-sorting/commit/4h5i6j7) - **SVG to ICO conversion**: added an initial `.svg` → `.ico` pipeline that renders at 16/24/32/256 px, encodes the layers as PNG, and assembles them into a single ICO file. [🡥](https://github.com/kh4f/svico/commit/b36cb72) - **Custom layer sizes**: added the `-s`/`--sizes` option to choose layer sizes (defaults to `16,24,32,256`, validated to the 1–256 range). [🡥](https://github.com/kh4f/svico/commit/75fa69d) ###   🩹 Fixes - **Fixed RMB drag activation**: holding the right mouse button no longer triggers drag & drop. [🡥](https://github.com/kh4f/manual-sorting/commit/7f1a2b3) [#114](https://github.com/kh4f/manual-sorting/issues/114) - **Reliable drop zone cleanup**: drop zones now always clear when releasing the mouse, even outside Obsidian or after opening context menus on Mac. [🡥](https://github.com/kh4f/manual-sorting/commit/8c9d0e1) [#115](https://github.com/kh4f/manual-sorting/issues/115) [#116](https://github.com/kh4f/manual-sorting/issues/116) ###   📋 Docs - **Documented ICO pipeline**: added documentation for the ICO format and the rendering pipeline. [🡥](https://github.com/kh4f/svico/commit/9532ec7) #####    [Commit log](https://github.com/kh4f/manual-sorting/compare/v3.2.2...v3.2.3)  •  Dec 26, 2025 ``` ```markdown ##   ` 🏷️ v3.2.2 ` ###   🩹 Fixes - **Improved multi-selection dragging**: - Nested folders no longer escape to the parent level. [🡥](https://github.com/kh4f/manual-sorting/commit/4a5b6c7) [#113](https://github.com/kh4f/manual-sorting/issues/113) - Prevented accidental nesting of selected items. [🡥](https://github.com/kh4f/manual-sorting/commit/1d2e3f4) - Disallowed dropping a multi-selection into folders that are part of the same selection. [🡥](https://github.com/kh4f/manual-sorting/commit/9e8d7c6) - **Refined drop zone behavior**: - Drop zones no longer appear in default sorting modes. [🡥](https://github.com/kh4f/manual-sorting/commit/0f1e2d3) - Fixed phantom drop zones appearing near empty folders. [🡥](https://github.com/kh4f/manual-sorting/commit/8a7b6c5) - **Accurate drag tooltip**: the drag tooltip now always displays the correct target folder name. [🡥](https://github.com/kh4f/manual-sorting/commit/3d4e5f6) ###   🎨 Style - **Clearer active drop indicator**: improved the visual clarity of the active drop zone for more precise positioning. [🡥](https://github.com/kh4f/manual-sorting/commit/7g8h9i0) - **Updated drag handle icon**: drag handles now use the more familiar 2×3 dot pattern. [🡥](https://github.com/kh4f/manual-sorting/commit/6b7c8d9) #####    [Commit log](https://github.com/kh4f/manual-sorting/compare/v3.2.1...v3.2.2)  •  Dec 24, 2025 ``` ```markdown ##   ` 🏷️ v3.0.0 ` ###   📢 BREAKING CHANGES - The settings storage format has been completely redesigned. **Your existing settings, including custom order, will be reset.** [🡥](https://github.com/kh4f/manual-sorting/commit/4l5m6n7) - The option to **disable dragging has been removed**. [🡥](https://github.com/kh4f/manual-sorting/commit/8o9p0q1) ###   🩹 Fixes - **Fixed mobile folder expansion**: resolved issues where folders wouldn't open when tapped on mobile. [🡥](https://github.com/kh4f/manual-sorting/commit/2j3k4l5) [#118](https://github.com/kh4f/manual-sorting/issues/118) - **Enhanced drag boundaries**: drag events now properly handle interactions outside the file explorer. [🡥](https://github.com/kh4f/manual-sorting/commit/0i1j2k3) - **Fixed keyboard selection issue**: resolved incorrect note highlighting when using keyboard navigation. [🡥](https://github.com/kh4f/manual-sorting/commit/6u7v8w9) [#46](https://github.com/kh4f/manual-sorting/issues/46) - **Wider touch activation area**: expanded the drag zone width for more reliable dragging on mobile. [🡥](https://github.com/kh4f/manual-sorting/commit/6m7n8o9) ###   ⚡ Performance - **Smaller ICO files**: PNG layers are now compressed with Oxipng at max compression to shrink the resulting `.ico` size. [🡥](https://github.com/kh4f/svico/commit/9104b4d) ###   📦 Distribution - **Direct binary in zips**: prebuilt release zips now place the executable at the archive root, so extracting yields `svico` immediately. [🡥](https://github.com/kh4f/svico/commit/0647223) #####    [Commit log](https://github.com/kh4f/manual-sorting/compare/v2.5.1...v3.0.0)  •  Nov 6, 2025 ```