skills.rest
web-infra-dev
web-infra-devOFFICIAL
Explore all skills by this author →
Website𝕏@rspack_devGitHub

release-blog-writer

Write and revise product release blog posts following established style conventions.

12.9k|843|Updated Apr 1, 2022
Search Tags:#release notes#multilingual#Technical Writing#announcement#blog writing#Rspress#ChangeLog
One-click install
npx skills add https://github.com/web-infra-dev/rspack --skill release-blog-writer
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: release-blog-writer
Source: https://github.com/web-infra-dev/rspack/tree/main/.agents/skills/release-blog-writer
Command: npx skills add https://github.com/web-infra-dev/rspack --skill release-blog-writer

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Drafting release announcements that read like polished product communication rather than raw changelog output is time-consuming, and keeping tone, headings, anchors, and links consistent across languages and past posts is error-prone.

Core Features & Use Cases

  • Release Post Drafting: Write new release blog posts in English, Chinese, or other languages, mirroring the style of previous major or minor release posts.
  • Structured Section Writing: Each feature section explains background, purpose, use cases, and user-facing benefits with selective code examples instead of exhaustive API lists.
  • Heading and Anchor Management: Enforces sentence-case headings and stable anchors, including Rspress {#anchor-id} syntax and cross-language anchor consistency.
  • Targeted Revision: Applies small, consistent edits to existing posts while preserving the user's manual changes.
  • Use Case: When shipping Rspack v1.5, ask the assistant to draft the release blog post based on the changelog, matching the tone and structure of the v1.4 announcement with correct documentation links.

Quick Start

Use the release-blog-writer skill to draft a release blog post for the upcoming version based on these changelog notes.

Frequently Asked Questions about release-blog-writer

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I write a release blog post from a changelog?▼

Provide the changelog or feature list and ask for a release blog post. The skill selects key changes, explains their background and user benefits, and avoids turning the post into an exhaustive changelog.

How to revise an existing release announcement draft?▼

Share the existing draft and describe the changes you want. The skill makes small targeted edits, keeps your manual changes intact, and applies removals consistently across the whole post.

Can release blog posts be written in Chinese or other languages?▼

Yes, posts can be written in any requested language while the writing rules stay language-agnostic. For multilingual posts, the English version defines section anchors, and other languages use custom anchors to match.

Does it support Rspress heading anchor syntax?▼

Yes, it uses the Rspress `{#anchor-id}` syntax when the site is built with Rspress. Custom anchors are added only when the default generated anchor would differ or is not stable enough.

How are documentation links handled in release posts?▼

Links point to product documentation, upstream PRs, or platform references at the first meaningful occurrence. For Rstack sites, Chinese posts use /zh/ paths while English posts use the default English URLs.

Related Skills

Explore More Content & Communication Skills→
wojonswojons
4

git-release

Generate release notes and version bumps from merged Git pull requests.

Community
Intermediate
hacsat88-bliphacsat88-blip

launch-strategy

Plan product launches with phased rollouts and channel strategies.

Community
Advanced
aimentor606aimentor606

brand-voice

Document brand voice guidelines with voice attributes, tone rules, and terminology lists.

Community
Intermediate
sgcarstrendssgcarstrends
21

changelog

Generate CHANGELOG.md from conventional commits using semantic-release.

Official
Advanced