feat: add release-notes skill for curated changelogs and README updates#458
Merged
feat: add release-notes skill for curated changelogs and README updates#458
Conversation
Adds a new skill at .claude/skills/release-notes/SKILL.md that guides agents through generating polished, highlight-driven release notes instead of the default GitHub auto-generated PR lists. The skill covers: - Gathering changes between tags via git log and gh CLI - Categorizing commits (features, fixes, perf, mobile, multi-agent) - Writing curated highlights with user-focused language - Publishing via gh release edit - README update strategy (when and what to change) - Quick reference commands for common release tasks Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
- Update PR Review Squad description to reflect mixed-model architecture (Opus workers dispatching Opus + Sonnet + Codex sub-agents) - Update Fiesta Mode to mention pairing string and push-to-pair - Add /agent to slash commands list - Add new 'CLI Agent & Skill Visibility' feature section Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
README overhaul: - Add version/download/platform badges - Add dashboard and chat screenshots inline - Replace wall-of-subsections with consolidated, scannable feature blocks - Lead with a quick-scan value prop table instead of bullet list - Merge related features (agent visibility + model selection = one section) - Add platform install links directly in the supported platforms table - Remove implementation details (watchdog tiers, connection modes, etc.) - Update test count to 2,900+ Skill refinements: - Make reading PR bodies a primary step (not optional) - Add README philosophy section: 'The README Sells, It Doesn't Document' - Add good/bad voice examples for README writing - Add per-platform asset download links to release note template - Add trigger table for when to update which README section Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Owner
Author
Code Review -- PR #458Build: ✅ Passes (0 errors) | Tests: ✅ 3,061 pass | Risk: None (docs-only) ✅ Verdict: Ship itDocumentation-only PR -- new release-notes skill + README rewrite. No code changes, no risk. Minor suggestions (non-blocking):
|
- Fix test count: 2,900+ → 3,000+ (actual: 3,061) - Fix iOS install: TestFlight → Build from source (no public link) - Restore dropped features: Notifications, Tailscale, Demo Mode - Clarify Linux asset naming in skill template with actual examples Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
PureWeen
added a commit
that referenced
this pull request
Apr 1, 2026
…461) ## Summary Adds a new **Step 5: Generate Social / Announcement Post** to the release-notes skill. When an agent runs the release-notes workflow, it now also generates copy-paste-ready announcement text for: - **LinkedIn** (long-form) — hook + highlights + one-liner + install link + hashtags, kept under 1300 chars - **Twitter/X / Bluesky** (short-form) — compact bullet format with link ### Writing rules baked into the skill - Lead with the hook, not the version number - Benefits, not implementation details - Include a one-liner for readers who don't know PolyPilot - Hashtags at the end, never inline ### Example output (v1.0.15) > 🚀 PolyPilot v1.0.15 is out! > > You can now spread your AI coding agents across every machine on your LAN. > > What's new: > 🔹 Fiesta Mode — discover other PolyPilot instances, pair in one click, and dispatch tasks to any machine > 🔹 Mixed-Model PR Review — 5 workers each run 3 sub-agents and synthesize consensus reviews > 🔹 CLI Agent Visibility — see when Copilot invokes specialized agents, plus a new /agent command Follows up on #458 (merged). No code changes — skill doc only. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
arisng
pushed a commit
to arisng/PolyPilot
that referenced
this pull request
Apr 4, 2026
…es (PureWeen#458) ## Summary Adds a new skill at `.claude/skills/release-notes/SKILL.md` that teaches agents how to generate polished, highlight-driven release notes instead of the default GitHub auto-generated PR lists. ## What the skill covers - **Gathering changes** between tags via `git log` and `gh` CLI - **Categorizing commits** into Highlights, Features, Fixes, Performance, Mobile, Multi-Agent, Infrastructure, Docs - **Writing curated highlights** with user-focused, active-voice language - **Publishing** via `gh release edit` to update existing GitHub Releases - **README update strategy** — when to add features, what sections to touch, what to avoid - **Quick reference commands** for common release tasks ## Before vs After **Before** (current v1.0.15 release notes): > ## What's Changed > * fix: cleared input fields re-fill with stale draft text on re-render by @PureWeen in PureWeen#435 > * fix: orchestrator prompt minimizes worker fan-out for single tasks by @PureWeen in PureWeen#429 > *(17 more undifferentiated bullet points...)* **After** (skill-guided format): > ## 🚀 Highlights > - **Fiesta Mode** — Discover and orchestrate across multiple PolyPilot instances on your LAN with push-to-pair (PureWeen#322) > - **Mixed-Model PR Review Squad** — New preset combining Opus, Sonnet, and Codex for comprehensive code review (PureWeen#451) > > ## ✨ New Features > - Surface CLI subagent and skill events directly in chat + `/agent` command (PureWeen#445) > *(categorized, concise, scannable...)* ## Testing This is a documentation-only skill file — no code changes, no tests needed. --------- Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
arisng
pushed a commit
to arisng/PolyPilot
that referenced
this pull request
Apr 4, 2026
…ureWeen#461) ## Summary Adds a new **Step 5: Generate Social / Announcement Post** to the release-notes skill. When an agent runs the release-notes workflow, it now also generates copy-paste-ready announcement text for: - **LinkedIn** (long-form) — hook + highlights + one-liner + install link + hashtags, kept under 1300 chars - **Twitter/X / Bluesky** (short-form) — compact bullet format with link ### Writing rules baked into the skill - Lead with the hook, not the version number - Benefits, not implementation details - Include a one-liner for readers who don't know PolyPilot - Hashtags at the end, never inline ### Example output (v1.0.15) > 🚀 PolyPilot v1.0.15 is out! > > You can now spread your AI coding agents across every machine on your LAN. > > What's new: > 🔹 Fiesta Mode — discover other PolyPilot instances, pair in one click, and dispatch tasks to any machine > 🔹 Mixed-Model PR Review — 5 workers each run 3 sub-agents and synthesize consensus reviews > 🔹 CLI Agent Visibility — see when Copilot invokes specialized agents, plus a new /agent command Follows up on PureWeen#458 (merged). No code changes — skill doc only. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Adds a new skill at
.claude/skills/release-notes/SKILL.mdthat teaches agents how to generate polished, highlight-driven release notes instead of the default GitHub auto-generated PR lists.What the skill covers
git logandghCLIgh release editto update existing GitHub ReleasesBefore vs After
Before (current v1.0.15 release notes):
After (skill-guided format):
Testing
This is a documentation-only skill file — no code changes, no tests needed.