Agent skill

Pre Changelog

by MoonshotAI in MoonshotAI/kimi-code

Use before merging a kimi-code release PR to preview the user-facing CLI changelog in Chinese.

MITAuto-check passedDevelopment

Install Pre Changelog

skills CLI
$ npx skills add MoonshotAI/kimi-code --skill pre-changelog -a claude-code

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

GitHub CLI
$ gh skill install MoonshotAI/kimi-code pre-changelog --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/MoonshotAI/kimi-code.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/pre-changelog .claude/skills/pre-changelog && 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
pre-changelog
GitHub stars
7.8k
Token cost
~1.6k tokens
SKILL.md length
804 words
Files
1
Skills in repo
11
Repo updated
First seen
Licence
MIT

At a glance

Use before merging a kimi-code release PR to preview the user-facing CLI changelog in Chinese.

  • Works in 4 steps: Locate the release PR → Read the pre-generated CLI changelog block → Render the Chinese preview (reuse… → …
  • Tasks that involve Changelog and release notes
  • SKILL.md covers Workflow and Rules
  • Calls gh; reaches moonshotai.github.io

What it does

Pre Changelog is an agent skill from MoonshotAI/kimi-code. Use before merging a kimi-code release PR to preview the user-facing CLI changelog in Chinese. Reads the changelog that changesets pre-generated in the release PR, then reuses sync-changelog's strip / classify / translate logic to render a Chinese preview. Writes no files.

Its SKILL.md is about 1.6k 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 Kimi. The repository describes itself as: Kimi Code CLI — The Starting Point for Next-Gen Agents. The licence is MIT.

When your agent uses it

  • Tasks that involve Changelog and release notes

Example prompts

  • “/pre-changelog”

Workflow steps

4 steps, taken from the step headings in SKILL.md.

  1. Locate the release PR
  2. Read the pre-generated CLI changelog block
  3. Render the Chinese preview (reuse sync-changelog)
  4. Output

What it can do on your machine

Read from SKILL.md and the folder at commit e5b4b88. 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:

    • gh

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

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • moonshotai.github.io

    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

Pre Changelog loads about 1.6k tokens when it runs. Until then it costs about 72 tokens; SKILL.md has 804 words of instructions outside code blocks.

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

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 MoonshotAI/kimi-code at commit e5b4b88, republished under its MIT licence (© MoonshotAI). 804 words, ~1,597 tokens.

Download SKILL.mdSave it as .claude/skills/pre-changelog/SKILL.md (or your agent's skills folder).
name
pre-changelog
description
Use before merging a kimi-code release PR to preview the user-facing CLI changelog in Chinese. Reads the changelog that changesets pre-generated in the release PR, then reuses sync-changelog's strip / classify / translate logic to render a Chinese preview. Writes no files.

Pre-Changelog

Preview the user-facing Chinese changelog of an open kimi-code release PR before it is merged. Read-only: this skill writes no files and commits nothing.

This skill reuses sync-changelog's strip / classify / translate rules. Read sync-changelog first; only the data source (release PR diff instead of a published CHANGELOG.md) and the output (preview instead of docs files) differ.

Workflow

1. Locate the release PR
bash
gh pr list --state open --search "ci: release packages in:title" \
  --json number,title,url,headRefName,baseRefName

Pick the one with headRefName: changeset-release/main; record number, url as <RELEASE>. If none is open, nothing to preview — stop.

2. Read the pre-generated CLI changelog block

changesets already pre-generates apps/kimi-code/CHANGELOG.md inside the release PR. Extract the new version block from the diff:

bash
gh api repos/MoonshotAI/kimi-code/pulls/<RELEASE>/files \
  --jq '.[] | select(.filename=="apps/kimi-code/CHANGELOG.md") | .patch'

Take the added lines (+) from the top ## <version> down to (but not including) the next ## . That is the version block to preview.

If the CLI changelog is not in the diff (for example an SDK-only release), stop and tell the user — there is no user-facing CLI changelog to preview.

3. Render the Chinese preview (reuse sync-changelog)

Process the version block exactly as sync-changelog does for the docs site, but only in memory:

  • Strip (sync-changelog step 3): drop the H1, the ### Patch Changes / ### Minor Changes / ### Major Changes subheadings, PR links, and commit-hash links; keep only each entry's body text. The Thanks [@user](...)! credit (including the multi-author form) must be removed every time. Within each entry, drop SDK-only and provider-internal sentences (SDK capability mapping / API exposure, provider wire-format mechanics, internal XML markers, hook/event payload mechanics such as what an event reports or carries) and keep only the user-facing effect and required constraints.
  • Merge and deduplicate (sync-changelog step 4): merge micro-tweaks to the same surface into one higher-level entry; when three or more fixes target the same UI area or the same class of problem, merge them into one higher-level fix entry (do not merge broad or genuinely distinct fixes); and drop a server/API entry that only backs a web feature already listed.
  • Collapse low-signal entries (sync-changelog step 4): keep standalone only entries that pass both gates — the reader-action test (the reader must do or re-evaluate something) and the channel test (the product cannot push it into the user's path: hidden controls, habit invalidations, capabilities users would not know to seek — a control merely sitting in the UI is not surfacing, users do not explore). Polish keeps only must-react items; experiences the product shows at the moment of need (recovery cards, post-install guidance) fold. Fixes keep only behavior-change entries (readers must update a habit, config, or workaround); loud failures fold (the fix itself notifies the victim), and silent past damage folds too — the changelog does not repair the past, and a notice that names no locatable instance and no realistic action is noise, not diligence. Section sizes follow density defaults (about 2 polish, 3 fixes) that yield to genuinely qualifying entries — flag the overflow for the reviewer instead of folding to hit the number. Fold everything else into one catch-all line placed last under 修复 — 修复了一些已知问题。 (or 修复了一些已知问题,并做了若干细节优化。 when non-fix entries were also collapsed; when nothing folded is a fix, place it under 优化 instead as 做了若干细节优化和内部改进。), followed by a separate pointer sentence: 更详细的变更记录见 [GitHub](https://github.com/MoonshotAI/kimi-code/blob/main/apps/kimi-code/CHANGELOG.md)。 (file link, no version anchor; before the release PR merges, the target does not yet contain this version's block — expected for a preview).
  • Classify (sync-changelog step 4): bucket into Features / Bug Fixes / Polish / Refactors / Other; order within each section by reader value (in Polish, user-visible improvements before protocol/internal adjustments).
  • Translate (sync-changelog step 6): translate entry bodies to Chinese; keep one sentence per entry with a parallel rhythm within a section; section headings become 新功能 / 修复 / 优化 / 重构 / 其他.
Show full SKILL.md (209 more words)Show less

If an upstream entry is not in English, flag it and stop (changeset entries must be English).

4. Output

Print the preview directly. Use <version>(预览) as the heading because the version is not released yet. Write 无 for empty sections. Do not write any file.

After the preview block, append a reviewer-only section titled ### 审稿参考(不进入文档): list every entry folded into the catch-all (short English title, one line each), note any section that exceeds the density defaults, and flag borderline calls for the reviewer to confirm. This breakdown is how reviewers see what was folded — before merge, the catch-all pointer's target does not yet contain the version's block. Never write this section into the docs pages.

The preview is pasted into chat tools (for example Lark), where relative docs links do not resolve. Rewrite every docs link to its absolute published URL: map ../<path>.md[#anchor] to https://moonshotai.github.io/kimi-code/zh/<path>.html[#anchor] — for example ../configuration/config-files.md#loop-control → https://moonshotai.github.io/kimi-code/zh/configuration/config-files.html#loop-control. Never emit raw relative paths, and never wrap a link in backticks; code-style the link text inside the brackets instead (loop_control).

发版 PR: <url>

## <version>(预览)

### 新功能
- ...

### 修复
- ...

Rules

  • Read-only. Never write CHANGELOG.md, docs files, or commit anything.
  • Classification, ordering, and translation follow sync-changelog exactly — do not reword or reclassify beyond what it specifies.
  • If the release PR has no CLI changelog diff, report it and stop.

© MoonshotAI, MIT. 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/pre-changelog of MoonshotAI/kimi-code.

Open the folder on GitHubat commit e5b4b88

Compare with similar skills

Pre Changelog 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.

Pre Changelog compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Pre Changelog this skillMoonshotAI/kimi-code7.8k—~1.6kAutomated safety check: PassMIT
Pulse Releasequnqin24/Pulse521—~1.3kAutomated safety check: PassApache-2.0
Simple Englishmoeru-ai/airi50k2 repos~4.6kAutomated safety check: PassMIT
StarRocks Release NotesStarRocks/starrocks12k—~1.9kAutomated safety check: NotesApache-2.0
Cutting A ReleaseTriliumNext/Trilium38k—~3.2kAutomated safety check: PassAGPL-3.0
Mole CLI Release Flowtw93/Mole70k—~2.6kAutomated safety check: PassGPL-3.0

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 yesterday
    DevelopmentAuto-check passed
  • Simple English

    moeru-ai/airi

    Write or rewrite technical text with the rules of ASD-STE100 Simplified Technical English so it is clear, unambiguous, and free of AI slop.

    50k GitHub starsUsed in 2 repos~4.6k tokens
    DevelopmentAuto-check passed
  • StarRocks Release Notes

    StarRocks/starrocks

    Drafts English release notes for a StarRocks patch release from the PRs merged into its release branch, then opens a documentation PR and hands translation to /translate.

    12k GitHub stars~1.9k tokensUpdated today
    DevelopmentAuto-check: notes
  • Cutting A Release

    TriliumNext/Trilium

    A skill your agent uses when cutting, preparing, or debugging a Trilium release — bumping the monorepo version, tagging, or diagnosing a failed "Release" workflow run.

    38k GitHub stars~3.2k tokensUpdated today
    DevelopmentAuto-check passed
  • Runbook for assessing and executing a Mole CLI release: distribution channels, pre-flight checks, capital-V tags, build artifacts and the handoff to curated release notes.

    70k GitHub stars~2.6k tokensUpdated today
    DevelopmentAuto-check passed
  • React Router Release Notes Prep

    remix-run/react-router

    Polishes pending React Router change files before the versioning scripts run, and decides whether a long-form What's Changed section is warranted.

    57k GitHub stars~1.1k tokensUpdated yesterday
    DevelopmentAuto-check passed

More from MoonshotAI/kimi-code

All 11 skills in this repo
  • Kimi Webbridge

    MoonshotAI/kimi-code

    Kimi Browser Extension(Kimi 浏览器扩展,原 Kimi WebBridge)lets AI control the user's real browser — navigate, click, type, read, screenshot, and interact with any website using the user's actual login…

    7.8k GitHub stars~3.6k tokensUpdated today
    Auto-check passed
  • Gen Changesets

    MoonshotAI/kimi-code

    A skill your agent uses when generating changesets in the kimi-code repository — deciding whether to write one, which package to list, the bump level, the wording, and the confirmation workflow.

    7.8k GitHub stars~1.1k tokensUpdated today
    Auto-check passed
  • Gen Docs

    MoonshotAI/kimi-code

    Update Kimi Code CLI user documentation after meaningful code changes that affect product behavior or user experience.

    7.8k GitHub stars~1.2k tokensUpdated today
    Auto-check passed
  • Kimi Datasource

    MoonshotAI/kimi-code

    Universal data-source assistant for stocks (Wind, S&P, SEC EDGAR), macro (World Bank, IMF, FRED, NBS), Chinese government data and standards (GB/HB/DB/TT), corporate, academic, legal, WHO/FAO/OECD…

    7.8k GitHub stars~1.8k tokensUpdated today
    Auto-check passed
  • Review PR

    MoonshotAI/kimi-code

    在 kimi-code 仓库里 review 一个 PR 时使用:按 PR 模板逐节核对描述与 diff,并单独做一轮"回归与用户影响"评审,给出影响等级与评审摘要,评审摘要用用户当前使用的语言。

    7.8k GitHub stars~1.1k tokensUpdated today
    Auto-check passed
  • Write PR

    MoonshotAI/kimi-code

    在 kimi-code 仓库里创建或更新 PR 时使用:如何把 PR 模板的每一节写得简洁、便于 reviewer 理解,包括"行为变化与受影响人群"表。

    7.8k GitHub stars~909 tokensUpdated today
    Auto-check passed

Works with

Categories

Questions about Pre Changelog

What does Pre Changelog do?

Use before merging a kimi-code release PR to preview the user-facing CLI changelog in Chinese. Pre Changelog is an agent skill from MoonshotAI/kimi-code. Use before merging a kimi-code release PR to preview the user-facing CLI changelog in Chinese.

When should I use Pre Changelog?

Pre Changelog fits situations like: tasks that involve Changelog and release notes.

How do I install Pre Changelog in Claude Code?

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

How do I install Pre Changelog in Codex?

Run `npx skills add MoonshotAI/kimi-code --skill pre-changelog -a codex`. Or copy the skill folder (.agents/skills/pre-changelog in MoonshotAI/kimi-code) into .agents/skills/pre-changelog in your project. Codex loads it when a task matches its description.

Can I use Pre Changelog 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 MoonshotAI/kimi-code --skill pre-changelog -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/pre-changelog, .gemini/skills/pre-changelog, .github/skills/pre-changelog and .opencode/skills/pre-changelog in your project.

What does Pre Changelog need to run?

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

Does Pre Changelog access the network?

SKILL.md names 1 domain. In commands or code: moonshotai.github.io; the agent is likely to contact it when it follows the instructions. This is read from the text; nothing was executed.

Is Pre Changelog 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 Pre Changelog use?

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

How many tokens does Pre Changelog use?

About 1.6k tokens (SKILL.md is roughly 6.4k 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 Pre Changelog?

Skills that share tags, products or a category with Pre Changelog: Pulse Release (qunqin24/Pulse, 521 stars), Simple English (moeru-ai/airi, 50k stars), StarRocks Release Notes (StarRocks/starrocks, 12k stars) and Cutting A Release (TriliumNext/Trilium, 38k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Pre Changelog?

MoonshotAI (a GitHub organization) maintains it in MoonshotAI/kimi-code, which has 7,816 GitHub stars. The repository holds 11 skills in this directory. The repository was last updated on October 10, 2026.

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