release-notes
npx machina-cli add skill pcatattacks/solopreneur-plugin/release-notes --openclawRelease Notes: $ARGUMENTS
You are generating release announcements. Parse $ARGUMENTS for:
- Audience: customers, internal team, engineers, investors, social media (default: customers)
- Version/Scope: Optional version number or feature scope
Process
-
Gather context:
- Read recent git log for commits and changes
- Read any specs in
.solopreneur/specs/relevant to recent work - Read any plans in
.solopreneur/plans/ - Check for existing release notes in
.solopreneur/releases/
-
Delegate to the
@content-strategistsubagent to generate audience-appropriate content:For customers:
- Tone: Exciting, benefit-focused, clear
- Format: What's New → Why It Matters → How to Use It
- Focus on user impact, not technical details
For internal team / engineers:
- Tone: Technical, specific, actionable
- Format: Changelog with categories (Added, Changed, Fixed, Removed)
- Include file paths, API changes, migration notes
For investors:
- Tone: Business impact, growth-oriented
- Format: Key Metrics Impact → Strategic Significance → What's Next
- Connect features to revenue, retention, or market positioning
For social media:
- Tone: Punchy, shareable, hook-driven
- Format: 3 tweet-length announcements + 1 longer LinkedIn/blog post
- Include suggested hashtags and CTAs
-
Save to
.solopreneur/releases/{date}-{audience}-{slug}.md(create the directory if needed). -
Present the release notes to the CEO for review before publishing.
-
End with the next step prompt:
-> Release notes ready. What's next? Start your next feature: /solopreneur:discover [next idea] Or tell the story of what you just built: /solopreneur:story
Source
git clone https://github.com/pcatattacks/solopreneur-plugin/blob/main/skills/release-notes/SKILL.mdView on GitHub Overview
Generates audience-specific release announcements by analyzing recent commits, specs, plans, and existing notes. It targets customers, internal teams, investors, or social media, and can include an optional version or scope. Announcements are saved after shipping and reviewed by the CEO.
How This Skill Works
The tool reads recent git logs, specs in .solopreneur/specs/, plans in .solopreneur/plans/, and any existing release notes. It delegates content generation to the @content-strategist subagent to produce audience-appropriate content (format and tone per audience). The final notes are saved to .solopreneur/releases/{date}-{audience}-{slug}.md and presented to the CEO for review.
When to Use It
- After shipping a new customer-facing feature
- When releasing a bug fix or performance improvement to customers
- To inform internal teams about code changes and migrations
- To brief investors on business impact and growth potential
- To publish social media announcements with engagement hooks
Quick Start
- Step 1: Gather context from recent git logs, specs in .solopreneur/specs/, plans in .solopreneur/plans/, and any existing releases.
- Step 2: Specify the audience (customers, internal team, investors, social media) and optional Version/Scope, then generate audience-appropriate notes.
- Step 3: Save to .solopreneur/releases/{date}-{audience}-{slug}.md and present to the CEO for review.
Best Practices
- Tailor tone and format to each audience (customers, internal, investors, social media).
- Include the optional Version/Scope if provided to give clarity on what changed.
- Highlight user impact and measurable outcomes (benefits, performance gains).
- For internal/engineers, include concrete details like file paths, API changes, and migration notes.
- Save notes consistently to .solopreneur/releases and route to the CEO for review before publishing.
Example Use Cases
- Customers: What's New — Faster search with 40% improvement, new filters; Why It Matters — Find results in half the time; How to Use It — Apply the new filters on the results page to narrow your search.
- Internal: Added: src/search/index.js; Changed: API /v2/search to support pagination; Fixed: memory leak in worker threads; Migration: run migrate-202406.sh to update DB schema.
- Investors: Key Metrics Impact — 12% uplift in DAU due to faster search and personalized results; Strategic Significance — Strengthens retention and monetization; What's Next — Roadmap alignment with upcoming AI-assisted features.
- Social media: Tweet 1 — We just shipped faster search with smarter filters. Tweet 2 — Pro tip: use the new filters to zero in on exactly what you need. Tweet 3 — Try it now and share your results. LinkedIn post — Our latest release speeds up search by 40%, adds intuitive filters, and improves accuracy. Hashtags: #ProductUpdate #TechNews #UX
- Release file example: .solopreneur/releases/20240608-public-feature-x-release.md containing the customer-facing What's New, Why It Matters, and How to Use It sections.
