SKILL.md
$27
Section
Purpose
Entry
Date, version, title
Category
New, Improved, Fixed, Deprecated (optional)
Description
What changed, why it matters
Link
To docs, blog, or in-app
Media
Screenshots, GIFs, videos (optional)
Best Practices
Content
- User benefit first: "You can now X" not "We added X"
- Concrete: Specific features, not vague "improvements"
- Scannable: Headlines, bullets, tags
- Searchable: If many entries, add search/filter
Organization
- Reverse chronological: Newest first
- Grouping: By version or date range
- Tags: Feature area, product module (optional)
- RSS/email: Notify subscribers of updates
Placement
- Subdomain: changelog.yourdomain.com
- Path: /changelog, /updates, /releases
- Embed: Widget in app or docs sidebar
- Link from: Footer, docs, in-app
Output Format
- Structure (layout, entry format)
- Entry template (fields, tone)
- Navigation (filters, search)
- SEO (index, metadata)
- Integration (embed, RSS, email)
Related Skills
- docs-page-generator: Changelog linked from docs
- docs-page-generator: API changelog for developers; docs includes API Reference
- blog-page-generator: Major releases may have blog posts
- top-banner-generator: Announce major updates on main site