writing-community

Write project-authored release notes, announcements, changelogs, and status updates for mixed audiences.

1|Updated Mar 24, 2026
One-click install
npx skills add https://github.com/SgtPooki/skills --skill writing-community-sgtpooki
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: writing-community
Source: https://github.com/SgtPooki/skills/tree/main/skills/writing-community
Command: npx skills add https://github.com/SgtPooki/skills --skill writing-community-sgtpooki

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Teams struggle to write public project communication that speaks as the project itself — release notes, announcements, and status updates often bury breaking changes, oversell features, or confuse mixed audiences of experts and newcomers. ## Core Features & Use Cases - Announcement structure: Enforces a fixed shape — what changed, who is affected, action required, compatibility/rollout, and links — so readers get the key facts in the first lines. - Changelog-first workflow: Maintains a Keep a Changelog file with SemVer discipline, then derives the human-readable release note as a curation of it, flagging version-number mismatches honestly. - Register-specific guidance: Covers warm-but-concrete feature announcements, factual incident status updates, and tightened security advisories with affected versions, impact, and mitigation. - Use Case: After shipping a release with a breaking change, use this Skill to update the changelog, then draft a release note that names the break up front and details migration steps under compatibility. ## Quick Start Use the writing-community skill together with writing-core to draft a release announcement for version 2.1.0 based on the current changelog.

Frequently Asked Questions about writing-community

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

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

Write the technical changelog first using Keep a Changelog categories (Added, Changed, Deprecated, Removed, Fixed, Security), then curate it into a release note. Pick what affects readers, translate to a mixed-audience register, and link each item to docs rather than re-explaining.

What structure should a project announcement follow?▼

Lead with what changed in one or two sentences, then who is affected, action required with exact commands, compatibility and rollout details, and links. Breaking changes must be named in the opening lines and detailed again under compatibility.

How should breaking changes be communicated in release notes?▼

Surface breaking changes twice: named in the opening lines, then detailed under compatibility with concrete migration steps. If a break shipped in a minor version, document the reality and flag the SemVer mismatch explicitly rather than hiding it.

Can I use this skill for personal blog posts or social replies?▼

No. This skill is for text the project publishes as itself. Personal posts, replies, and messages belong to the user's personal author-voice skill; if you personally announce project news, use this skill for structure plus the author-voice overlay.

How do I write a status update during an incident?▼

State facts, impact, current state, and next update time. Avoid apology theater and minimizing — one honest sentence about the failure and remediation beats a paragraph of reassurance.

Does writing-community work without writing-core?▼

No. The skill explicitly requires writing-core, and its gate step pipes the draft through writing-core's writingcheck.py script for validation, allowing up to three fix passes on reported errors.