skill-changeloglisted

# Skill Changelog Maintain a `CHANGELOG.md` inside the directory of any skill being worked on. Every meaningful edit to a skill warrants a dated, versioned entry. --- ## Skill Locations Skills live in one of two places — both are valid targets: 1. **Standalone skills**: `~/.claude/skills/<skill-name>/` or `.claude/skills/<skill-name>/` 2. **Plugin skills**: `~/.claude/plugins/marketplaces/<marketplace>/plugins/<plugin>/skills/<skill-name>/` — or in marketplace repos: `plugins/<plugin>/skills/<skill-name>/` `CHANGELOG.md` location depends on context — see **Location Detection** below. --- ## Location Detection Before writing `CHANGELOG.md`, determine where it belongs: 1. **Resolve the real path** of the `SKILL.md` being edited — the path may be a symlink (e.g. `~/.claude/skills/<name>/SKILL.md` symlinked to a repo location): ```bash readlink -f <path-to-SKILL.md> ``` Use the resolved canonical path for all directory traversal below. 2. Start from the skill's root directory (the folder containing the resolved `SKILL.md`). 3. Walk up the directory tree (up to 4 levels) looking for `.claude-plugin/plugin.json`. 4. **Plugin found:** the directory containing `.claude-plugin/` is the plugin root — place `CHANGELOG.md` there. 5. **Plugin not found:** the skill is standalone — place `CHANGELOG.md` next to `SKILL.md`. **Example — plugin skill (symlinked):** - Loaded via: `~/.claude/skills/create-release/SKILL.md` (symlink) - Resolved to: `[repo]/plugins/