Agent skill

Docs Changelog Writer

by lobehub in lobehub/lobehub

Writes bilingual English and Chinese product changelog pages for docs/changelog, with date-based file names, frontmatter rules and a factual, user-first tone.

Custom licenceAuto-check passedWriting & Content

Install Docs Changelog Writer

skills CLI
$ npx skills add lobehub/lobehub --skill docs-changelog -a claude-code

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

GitHub CLI
$ gh skill install lobehub/lobehub docs-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/lobehub/lobehub.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/docs-changelog .claude/skills/docs-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
docs-changelog
GitHub stars
83k
Token cost
~948 tokens
SKILL.md length
394 words
Files
1
Skills in repo
50
Repo updated
First seen
Licence
Custom licence

At a glance

Writes bilingual English and Chinese product changelog pages for docs/changelog, with date-based file names, frontmatter rules and a factual, user-first tone.

  • Works in 3 steps: title should match the H1 title in… → description should be concise and… → tags should be feature-oriented, not…
  • Writing a website changelog entry for a new release
  • SKILL.md covers Scope Boundary (Important), Mandatory Companion Skills, File and Naming Convention and Frontmatter Requirements, plus 8 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

The skill is for changelog pages under docs/changelog and explicitly not for GitHub Release notes, which belong to a separate version-release skill. Files use date-based names: a YYYY-MM-DD-topic.mdx file for English and a matching .zh-CN.mdx file for Chinese, and the pair must describe the same facts in the same order. Each file carries frontmatter with a title, a one-sentence description and feature-oriented tags, and the agent must also load the design voice file and the i18n skill.

The recommended structure is an H1 title, an opening paragraph of two to four sentences on user-visible impact, one to three capability sections and an improvements and fixes list. Writing rules keep claims factual and tied to shipped changes, lead with user value, prefer narrative over bullet dumps, avoid marketing exaggeration and localize naturally instead of translating sentence by sentence. Length runs from three to five short paragraphs for a small update up to six to ten for a large one, and the workflow starts by collecting facts from PRs, commits and issues and grouping them by user workflow.

When your agent uses it

  • Writing a website changelog entry for a new release
  • Producing matching English and Chinese changelog files
  • Turning merged PRs and commits into a user-facing narrative

Example prompts

  • “Write the changelog for this week's release in English and Chinese.”
  • “Draft a small-update changelog page from these merged pull requests, grouped by user workflow.”
  • “Check that the Chinese changelog file covers the same facts as the English one.”

Requirements

  • A docs site with a docs/changelog folder of MDX files

Workflow steps

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

  1. title should match the H1 title in meaning.
  2. description should be concise and user-facing.
  3. tags should be feature-oriented, not internal-team labels.

What it can do on your machine

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

    No scripts in the folder and no shell commands in SKILL.md (its code samples are markdown).

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

  • Network

    No URLs in SKILL.md.

    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

Docs Changelog Writer loads about 948 tokens when it runs. Until then it costs about 28 tokens; SKILL.md has 394 words of instructions outside code blocks.

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

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

Its licence (Custom licence) doesn't allow us to republish the file, so here is its outline and opening line. It has 394 words (~948 tokens).

“This skill is only for changelog pages in:”

— opening of SKILL.md by lobehub, Custom licence
name
docs-changelog

Read the full SKILL.md on GitHub

Files

Just SKILL.md in .agents/skills/docs-changelog of lobehub/lobehub.

Open the folder on GitHubat commit 35d442e

Compare with similar skills

Docs Changelog Writer 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.

Docs Changelog Writer compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Docs Changelog Writer this skilllobehub/lobehub83k—~948Automated safety check: PassCustom licence
Create Release Blogweb-infra-dev/rstest505—~4.7kAutomated safety check: PassMIT
Nbj Write Clearlydaniel-p-green/nbj-write-clearly117—~1.1kAutomated safety check: PassMIT
Aholo Viewer Docsmanycoretech/aholo-viewer1.1k—~341Automated safety check: PassMIT
Mintlify Claude Docslilinji/ai-infra-odyssey130—~8.2kAutomated safety check: PassNone
Dynamo Content DesignerDynamoDS/Dynamo2k—~1.6kAutomated safety check: PassApache-2.0

Similar skills

  • Create Release Blog

    web-infra-dev/rstest

    Generate a narrative version release blog post from commits within a tag range.

    505 GitHub stars~4.7k tokensUpdated today
    Writing & ContentAuto-check passed
  • Nbj Write Clearly

    daniel-p-green/nbj-write-clearly

    Drafts, revises, and audits reader-first technical and product documentation.

    117 GitHub stars~1.1k tokensUpdated 1 mo ago
    Writing & ContentAuto-check passed
  • Aholo Viewer Docs

    manycoretech/aholo-viewer

    Guides writing and maintaining Aholo Viewer documentation: README, AGENTS.md, architecture notes, bilingual manual pages and AI collaboration guides.

    1.1k GitHub stars~341 tokensUpdated today
    Writing & ContentAuto-check passed
  • Mintlify Claude Docs

    lilinji/ai-infra-odyssey

    Build, write, review, migrate, and maintain Mintlify documentation in a restrained Claude Docs-inspired style.

    130 GitHub stars~8.2k tokensUpdated 11 days ago
    Writing & ContentAuto-check passed
  • Technical writing specialist for Dynamo product documentation, blog posts, tutorials, and educational content.

    2k GitHub stars~1.6k tokensUpdated today
    Writing & ContentAuto-check passed
  • Omh Content Operator

    rlaope/oh-my-hermes

    [omh] Product or company copy to publish or rewrite: scope publish-ready writing, rewriting, summarization, translation, release-note, newsletter, customer-copy, social-copy, README-copy, and…

    3.2k GitHub stars~1.9k tokensUpdated yesterday
    Writing & ContentAuto-check passed

More from lobehub/lobehub

All 50 skills in this repo
  • Builds single-file interactive HTML prototypes rendered with the real LobeHub UI components and written as production-style React, so they can later be split into files.

    83k GitHub stars~1.6k tokensUpdated today
    Auto-check passed
  • Verifies a delivery end to end by driving the real product on a CLI, web, desktop or iOS Simulator surface, capturing evidence and publishing a round with the lh CLI.

    83k GitHub stars~9.7k tokensUpdated today
    Auto-check passed
  • Git Worktree Cleanup

    lobehub/lobehub

    Audits stale Git worktrees and branches with a bundled script, classifies each one, and deletes only after you approve the exact candidates.

    83k GitHub stars~2.8k tokensUpdated today
    Auto-check passed
  • Maintains LobeHub's model-backed alint rule set: writing rules, removing false positives against real code, deciding warn versus error and tracking token cost.

    83k GitHub stars~1.9k tokensUpdated today
    Auto-check passed
  • Guides building LobeHub builtin agent tools, from the manifest and execution runtime to executors, chat UI renders and registry wiring.

    83k GitHub stars~2.4k tokensUpdated today
    Auto-check passed
  • Explains how LobeHub client code fetches data through services, SWR store hooks and cache keys, and when to avoid useEffect fetching or duplicated state.

    83k GitHub stars~1.7k tokensUpdated today
    Auto-check passed

Questions about Docs Changelog Writer

What does Docs Changelog Writer do?

Writes bilingual English and Chinese product changelog pages for docs/changelog, with date-based file names, frontmatter rules and a factual, user-first tone. The skill is for changelog pages under docs/changelog and explicitly not for GitHub Release notes, which belong to a separate version-release skill.mdx file for Chinese, and the pair must describe the same facts in the same order.

When should I use Docs Changelog Writer?

Docs Changelog Writer fits situations like: writing a website changelog entry for a new release; producing matching English and Chinese changelog files; turning merged PRs and commits into a user-facing narrative.

How do I install Docs Changelog Writer in Claude Code?

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

How do I install Docs Changelog Writer in Codex?

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

Can I use Docs Changelog Writer 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 lobehub/lobehub --skill docs-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/docs-changelog, .gemini/skills/docs-changelog, .github/skills/docs-changelog and .opencode/skills/docs-changelog in your project.

What does Docs Changelog Writer need to run?

SKILL.md names no scripts, command-line tools or credentials: Docs Changelog Writer is instructions for the agent only. Our summary lists: A docs site with a docs/changelog folder of MDX files.

Does Docs Changelog Writer access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

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

Docs Changelog Writer has a licence file (the repository's licence) that doesn't match a standard licence. Read it on GitHub before reusing the skill.

How many tokens does Docs Changelog Writer use?

About 948 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 Docs Changelog Writer?

Skills that share tags, products or a category with Docs Changelog Writer: Create Release Blog (web-infra-dev/rstest, 505 stars), Nbj Write Clearly (daniel-p-green/nbj-write-clearly, 117 stars), Aholo Viewer Docs (manycoretech/aholo-viewer, 1.1k stars) and Mintlify Claude Docs (lilinji/ai-infra-odyssey, 130 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Docs Changelog Writer?

lobehub (a GitHub organization) maintains it in lobehub/lobehub, which has 83,074 GitHub stars. The repository holds 50 skills in this directory. The repository was last updated on October 9, 2026.

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