docs-changelog
Write website changelog pages under docs/changelog/*.mdx. Use for EN/ZH product update posts, changelog posts, update-log copy, or docs changelog edits; not GitHub Release notes.
npx skills add lobehub/lobehub --skill docs-changelog --agent claude-code
Same command for any agent — swap --agent for codex, cursor, copilot.
Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.
# Docs Changelog Writing Guide ## Scope Boundary (Important) This skill is only for changelog pages in: - `docs/changelog/*.mdx` This skill is **not** for GitHub Releases.\ If the user asks for release PR body / GitHub Release notes, load `../version-release/SKILL.md`. ## Mandatory Companion Skills For every docs changelog task, you MUST load: - `../../../DESIGN.md` (Voice & Content) - `../i18n/SKILL.md` (when EN/ZH pair is involved) ## File and Naming Convention Use date-based file names: - English: `docs/changelog/YYYY-MM-DD-topic.mdx` - Chinese: `docs/changelog/YYYY-MM-DD-topic.zh-CN.mdx` EN and ZH files must exist as a pair and describe the same release facts. ## Frontmatter Requirements Each file should include: ```md --- title: <Title> description: <1 sentence summary> tags: - <Tag 1> - <Tag 2> --- ``` Rules: 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. ## Content Structure (Recommended) Use this shape unless the user requests otherwise: 1. `# <Title>` 2. Opening paragraph (2-4 sentences): user-visible impact 3. 1-3 capability sections (optional `##` heading
- Scope Boundary (Important)
- Mandatory Companion Skills
- File and Naming Convention
- Frontmatter Requirements
- Content Structure (Recommended)
- Writing Rules
- EN/ZH Synchronization Rules
- Length Guidance
- Authoring Workflow
- Docs Changelog Template (English)
- Docs Changelog Template (Chinese)
- Quick Checklist
What does the docs-changelog skill do?
Write website changelog pages under docs/changelog/*.mdx. Use for EN/ZH product update posts, changelog posts, update-log copy, or docs changelog edits; not GitHub Release notes.
How do I install it?
Run `npx skills add lobehub/lobehub --skill docs-changelog --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.
Where does this skill come from?
From lobehub/lobehub, a repository with 81,252 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.
Is a popular skill a good skill?
Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.