Transform technical details into clear, user-centric release notes that explain why changes matter.Documentation Index
Fetch the complete documentation index at: https://docs.getcore.me/llms.txt
Use this file to discover all available pages before exploring further.
Tools Required
This skill runs using CORE memory only. No integrations required.Step 1: Gather Input
Ask the user to provide:- Raw materials: Tickets, PRDs, changelogs, Git logs, or product descriptions
- Product context: What is this product? Who uses it?
- Audience: Developers, business users, or both?
- Version: Release version number
- Release date (if known)
Step 2: Organize by Category
Group changes into these sections:- New Features — Entirely new capabilities
- Improvements — Enhancements to existing features
- Bug Fixes — Issues resolved
- Breaking Changes — Backward-incompatible updates (if applicable)
- Deprecations — Features being removed (if applicable)
Step 3: Translate Technical to User Benefits
For each change, identify the benefit to users, not the implementation detail. ❌ “Implemented Redis caching for dashboard APIs” ✅ “Dashboards load 3× faster, letting you analyze data without delays”Step 4: Write Clear, Concise Entries
Each entry should be:- 1-3 sentences max
- Plain language — no jargon or internal references
- Benefit-forward — explain why it matters
- User-centric tone — speak to what users care about
Step 5: Order by Priority
List most impactful changes first. Users often read only the first few entries.Output Format
Release Notes — [Product Name] v[Version] Released [Date] 🎉 New Features
- [Feature name]: [User benefit in 1-2 sentences. Explain why this matters.]
- [Feature name]: [User benefit in 1-2 sentences. Explain why this matters.]
- [Feature name]: [What changed and why it’s better. 1-2 sentences.]
- [Feature name]: [What changed and why it’s better. 1-2 sentences.]
- [Bug description]: [User impact that’s now resolved. 1 sentence.]
- [Bug description]: [User impact that’s now resolved. 1 sentence.]
- [Change]: [What changed and migration required. 2 sentences.]
- [Feature]: [What’s being removed and timeline. 2 sentences.]
Edge Cases
- Too many changes: Group minor improvements into “Various improvements and fixes.”
- No release date yet: Use “Coming soon” or omit the date.
- Internal jargon unavoidable: Explain technical terms in parentheses for non-technical users.
- Breaking changes: Be extra clear about migration steps and deadline.
- Security or urgent fixes: Lead with these, even if otherwise lower priority.
