Tooluck logoTooluck
SKILL.md

skillshare-changelog

Agent skill fromrunkids/skillshare

Generate CHANGELOG.md entry from recent commits in conventional format. Also syncs the website changelog page. Use this skill whenever the user asks to: generate a changelog, document what changed between tags, or create a new CHANGELOG entry. If you see requests like "write the changelog for v0.17", "what changed since last release", this is the skill to use. Do NOT manually edit CHANGELOG.md without this skill — it ensures proper formatting, user-perspective writing, and website changelog sync. For full release workflows (Release PR review, tests, draft assets, publication, announcements), use /release instead.

How to install skillshare-changelog

install skillshare-changelog
# install the skillshare pack with the skills CLI
npx skills add runkids/skillshare

# or add only this skill to Claude Code: copy the folder

.skillshare/skills/skillshare-changelog/

# into

~/.claude/skills/skillshare-changelog/ (all projects)

.claude/skills/skillshare-changelog/ (one project)

.skillshare/skills/skillshare-changelog/SKILL.md

MITFull file
1Review or generate a user-facing changelog entry. Prefer the open Release Please PR and its manifest version for an upcoming release. For historical work, $ARGUMENTS specifies the requested tag or commit range.
2
3**Scope**: This skill updates `CHANGELOG.md` and syncs the website changelog (`website/src/pages/changelog.md`). It does NOT generate RELEASE_NOTES, choose a new version, or handle the full release workflow — use `/release` for that.
4
5Before acting, run `python3 scripts/ai-context.py release`. That topic is the source of truth for authorization, changelog content and synchronization rules; this skill retains the entry-generation workflow.
6
7## Workflow
8
9### Step 1: Determine Version Range
10
11For an upcoming release, work on the Release PR branch and read `.github/release-please-manifest.json`. Verify the latest published tag and use its range to the Release PR head. Keep the proposed version; this skill does not authorize a version change. Tags may exist for unpublished drafts, so do not assume the highest local tag is the latest published release.
12
13For historical work, use the user-requested tags or range.
14
15### Step 2: Collect Commits
16
17```bash
18git log <previous-published-tag>..<release-pr-head-or-requested-tag> --oneline --no-merges
19```
20
21Review the generated Release Please entry before writing. Preserve useful manual examples and migration notes. Do not add a second entry for the same version.
22
23### Step 3: Categorize Changes
24
25Group commits by conventional commit type:
26…

Excerpt shown under the repository's MIT license.

More skills in skillshare

Keep exploring

Similar skill repositories

Newsletter

Join the Community

Subscribe to our newsletter for the latest news and updates