Agent skill

Changelog Generator

by Eslzzyl in Eslzzyl/Pixiv-SwiftUI

Generate user-facing changelogs from git history between two versions.

AGPL-3.0Auto-check passedDevelopment

Install Changelog Generator

skills CLI
$ npx skills add Eslzzyl/Pixiv-SwiftUI --skill changelog-generator -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install Eslzzyl/Pixiv-SwiftUI changelog-generator --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/Eslzzyl/Pixiv-SwiftUI.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/changelog-generator .claude/skills/changelog-generator && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
changelog-generator
GitHub stars
111
Token cost
~940 tokens
SKILL.md length
408 words
Files
1
Skills in repo
3
Repo updated
First seen
Licence
AGPL-3.0

At a glance

Generate user-facing changelogs from git history between two versions.

  • Works in 4 steps: Ask the user for the two versions (from… → If only one version is given (e.g.,… → If no version is given at all, ask the… → …
  • Asks to summarize changes
  • SKILL.md covers Version Resolution, Generating the Log, Changelog Format and Audience & Scope, plus 2 more sections
  • Calls git

What it does

Changelog Generator is an agent skill from Eslzzyl/Pixiv-SwiftUI. Generate user-facing changelogs from git history between two versions. Use this when the user asks to summarize changes, create release notes, or generate a changelog between releases.

Its SKILL.md is about 940 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Development, covering Changelog and release notes. It works with iOS, SwiftUI, macOS and Git. The repository describes itself as: 为现代 Apple 平台设计的第三方 Pixiv 客户端,支持 iOS/iPadOS/macOS. The licence is AGPL-3.0.

When your agent uses it

  • Asks to summarize changes
  • Create release notes
  • Generate a changelog between releases

Example prompts

  • “/changelog-generator”

Workflow steps

4 steps, taken from the first numbered list in SKILL.md.

  1. Ask the user for the two versions (from -> to) if not specified.
  2. If only one version is given (e.g., "changelog for v0.14.0"), treat it as from, and to defaults to HEAD.
  3. If no version is given at all, ask the user which version range they want.
  4. Resolve each version by checking in this order

What it can do on your machine

Read from SKILL.md and the folder at commit 1f4bc02. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • git

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use git, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Changelog Generator loads about 940 tokens when it runs. Until then it costs about 51 tokens; SKILL.md has 408 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~51
When it runs · the whole SKILL.md, loaded when a task matches
~940

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from Eslzzyl/Pixiv-SwiftUI at commit 1f4bc02, republished under its AGPL-3.0 licence (© Eslzzyl). 408 words, ~940 tokens.

Download SKILL.mdSave it as .claude/skills/changelog-generator/SKILL.md (or your agent's skills folder).
name
changelog-generator
description
Generate user-facing changelogs from git history between two versions. Use this when the user asks to summarize changes, create release notes, or generate a changelog between releases.

Changelog Generator Skill

Generate a user-facing changelog from git history between two versions. Use this when the user asks to summarize changes, create release notes, or generate a changelog between releases.

Version Resolution

  1. Ask the user for the two versions (from -> to) if not specified.
  2. If only one version is given (e.g., "changelog for v0.14.0"), treat it as from, and to defaults to HEAD.
  3. If no version is given at all, ask the user which version range they want.
  4. Resolve each version by checking in this order:
    • Git tags matching v<version> (e.g., v0.14.0). Use git tag --list 'v*' to list tags.
    • Commit messages containing version strings (e.g., "chore: bump version to 0.14.3"). Search with git log --oneline --grep="bump version".
    • If neither matches, ask the user for clarification.

Generating the Log

Once both references are resolved:

bash
git log --oneline <from-ref>..<to-ref>

Examine each commit message. Classify commits into categories. Merge multiple commits that logically belong to the same change into a single list item.

Changelog Format

  • Write in Simplified Chinese (简体中文).
  • Use no emoji unless the emoji is part of the actual code changes.
  • Structure by second-level Markdown headings (##) for categories.
  • Default categories: ## 新功能 (feat), ## 优化 (perf, refactor), ## 问题修复 (fix). Add custom categories when the content fits better (e.g., ## 本地化, ## 样式调整, ## 依赖更新).
  • Under each heading, use an unordered list (-) for each change item.
  • Each item ends with the contributor in parentheses: (@username). Use git log --format="%an" <from-ref>..<to-ref> or git shortlog -sne <from-ref>..<to-ref> to determine contributors. If multiple contributors worked on related commits, list all: (@user1, @user2).
  • If the author is the project owner and sole contributor, you may omit the contributor annotation.
Show full SKILL.md (138 more words)Show less

Audience & Scope

The changelog is for app users, not developers. Therefore:

  • Skip purely technical commits (e.g., CI config changes, dependency version bumps that don't affect behavior, internal refactoring, linting fixes, documentation-only changes) unless the user explicitly asks to include them.
  • Describe changes in user-facing terms. For example, "perf: replace KFImage with lightweight loader" becomes "优化图片加载性能,减少内存占用".
  • When a single user-facing feature was built across multiple commits, merge them into one item.

Examples

Given commits:

a1b2c3 feat: add bookmark visibility toggle in collection page
d4e5f6 fix: restore glass blur background on IllustCard tags
g7h8i9 perf: replace shadow() with CardShadowView for better performance
j0k1l2 chore: bump version to 0.14.3

Output:

## 新功能

- 收藏页新增公开/非公开筛选切换功能 (@user)

## 优化

- 优化 IllustCard 标签毛玻璃背景及阴影渲染性能 (@user)

## 问题修复

- 修复 IllustCard 标签毛玻璃背景丢失的问题 (@user)

Given commits with skip logic applied:

a1b2c3 feat: add bookmark visibility toggle
d4e5f6 chore: exclude pixez-flutter in swiftlint
g7h8i9 chore: bump version to 0.14.3

Output (lint config change and version bump are skipped as technical):

## 新功能

- 收藏页新增公开/非公开筛选切换功能 (by @user)

Verification

After generating the changelog, verify:

  1. All categories make sense for the changes listed.
  2. No emoji was included.
  3. Purely technical commits were excluded (unless user requested inclusion).
  4. Related commits are merged into single items.
  5. Each item is described from the user's perspective.

© Eslzzyl, AGPL-3.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in .agents/skills/changelog-generator of Eslzzyl/Pixiv-SwiftUI.

Open the folder on GitHubat commit 1f4bc02

Compare with similar skills

Changelog Generator next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Changelog Generator compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Changelog Generator this skillEslzzyl/Pixiv-SwiftUI111—~940Automated safety check: PassAGPL-3.0
Pulse Releasequnqin24/Pulse521—~1.3kAutomated safety check: PassApache-2.0
Commitmanhpham90vn/Deskhub133—~978Automated safety check: PassMIT
Releasevaayne/mori303—~1.2kAutomated safety check: PassMIT
Swiftui Whats New 27omarshahine/HomeClaw175—~1.4kAutomated safety check: PassMIT
Swiftui Whats New 27CamilleScholtz/swmpc239—~1.1kAutomated safety check: PassEUPL-1.2

Similar skills

  • Pulse Release

    qunqin24/Pulse

    Release a new Pulse version end to end — checks, bilingual CHANGELOG entry, VERSION, tag, the release workflow, syncing main, and the issue replies that go with it.

    521 GitHub stars~1.3k tokensUpdated 2 days ago
    DevelopmentAuto-check passed
  • Commit

    manhpham90vn/Deskhub

    Write a Deskhub commit message. An agent skill from manhpham90vn/Deskhub.

    133 GitHub stars~978 tokensUpdated today
    DevelopmentAuto-check passed
  • Release

    vaayne/mori

    Release workflow for Mori macOS workspace terminal and MoriRemote iOS app.

    303 GitHub stars~1.2k tokensUpdated 2 mo ago
    MobileAuto-check passed
  • Swiftui Whats New 27

    omarshahine/HomeClaw

    New SwiftUI APIs, behaviors, and deprecations in the 2027 OS releases (iOS 27 and aligned macOS/watchOS/tvOS/visionOS).

    175 GitHub stars~1.4k tokensUpdated 3 days ago
    MobileAuto-check passed
  • Swiftui Whats New 27

    CamilleScholtz/swmpc

    New SwiftUI features and patterns for iOS 27 and macOS 27: @State macro, reorderable containers, AsyncImage caching, and new swipe actions.

    239 GitHub stars~1.1k tokensUpdated 4 days ago
    MobileAuto-check passed
  • Release

    Shpigford/knockoff

    Cut a new Knockoff release — bump the version, roll release notes, tag, and ship to the Chrome Web Store, Firefox Add-ons (AMO), and the Mac & iOS App Store, reporting per-store status at the end.

    2k GitHub stars~2.1k tokensUpdated 2 mo ago
    DevelopmentAuto-check: notes

More from Eslzzyl/Pixiv-SwiftUI

  • Swiftui Expert Skill

    Eslzzyl/Pixiv-SwiftUI

    A skill your agent uses when writing, reviewing, or refactoring SwiftUI code for iOS or macOS, including state and @Observable data flow, view composition, resizable layouts, safe areas, display…

    111 GitHub starsUsed in 1 repo~2.9k tokens
    Auto-check passed
  • Xcstrings Manager

    Eslzzyl/Pixiv-SwiftUI

    Manage Xcode String Catalog (.xcstrings) localization files through a command-line interface.

    111 GitHub stars~482 tokensUpdated 3 days ago
    Auto-check passed

Categories

Questions about Changelog Generator

What does Changelog Generator do?

Generate user-facing changelogs from git history between two versions. Changelog Generator is an agent skill from Eslzzyl/Pixiv-SwiftUI. Generate user-facing changelogs from git history between two versions.

When should I use Changelog Generator?

Changelog Generator fits situations like: asks to summarize changes; create release notes; generate a changelog between releases.

How do I install Changelog Generator in Claude Code?

Run `npx skills add Eslzzyl/Pixiv-SwiftUI --skill changelog-generator -a claude-code`. Or copy the skill folder (.agents/skills/changelog-generator in Eslzzyl/Pixiv-SwiftUI) into .claude/skills/changelog-generator in your project. Claude Code loads it when a task matches its description.

How do I install Changelog Generator in Codex?

Run `npx skills add Eslzzyl/Pixiv-SwiftUI --skill changelog-generator -a codex`. Or copy the skill folder (.agents/skills/changelog-generator in Eslzzyl/Pixiv-SwiftUI) into .agents/skills/changelog-generator in your project. Codex loads it when a task matches its description.

Can I use Changelog Generator in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add Eslzzyl/Pixiv-SwiftUI --skill changelog-generator -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/changelog-generator, .gemini/skills/changelog-generator, .github/skills/changelog-generator and .opencode/skills/changelog-generator in your project.

What does Changelog Generator need to run?

Going by SKILL.md and its folder, Changelog Generator needs the command-line tools its instructions call (git).

Does Changelog Generator access the network?

SKILL.md contains no URLs. Its commands use git, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Changelog Generator safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Changelog Generator use?

Changelog Generator is published under the AGPL-3.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Changelog Generator use?

About 940 tokens (SKILL.md is roughly 3.8k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Changelog Generator?

Skills that share tags, products or a category with Changelog Generator: Pulse Release (qunqin24/Pulse, 521 stars), Commit (manhpham90vn/Deskhub, 133 stars), Release (vaayne/mori, 303 stars) and Swiftui Whats New 27 (omarshahine/HomeClaw, 175 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Changelog Generator?

Eslzzyl (a GitHub user) maintains it in Eslzzyl/Pixiv-SwiftUI, which has 111 GitHub stars. The repository holds 3 skills in this directory. The repository was last updated on October 7, 2026.

Source: Eslzzyl/Pixiv-SwiftUI on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.