Two docs & writing skills · both proven

changelog-generator vs writing-plans

Both skills were run through Claude twice: once on a fixed brief without the skill, once with it. The briefs differ because each is written for the job the skill claims to do, so compare each skill against its own baseline, then decide which difference matters for your work.

changelog-generator

Automatically creates user-facing changelogs from git commits by analyzing commit history, categorizing changes, and transforming technical commits into clear, customer-friendly release notes. Turns hours of manual changelog writing into minutes of automated generation.

Category: Docs & Writing
Source: ComposioHQ/awesome-claude-skills · 77,423 stars
License: Not stated
Proof model: claude-opus-5-5
Brief: “Turn these git commits into a user-facing changelog page for version 2.4.0 of Ledgerly, a small-business invoicing app, as a single HTML page. Commits: 'feat: recurring invoices with weekly, monthly and custom schedules'; 'feat: export invoices to CSV from the list view'; 'fix: PDF totals rounded incorrectly for invoices with more than 50 line items'; 'fix: late-fee reminder emails sent twice when a client had two contacts'; 'chore: bump node to 22'; 'refactor: move tax calculation into shared module'; 'feat: Stripe payouts show in the dashboard with a status badge'; 'fix: dark mode contrast on the settings page'; 'docs: update API examples for the invoices endpoint'.”
Skill commit: be2a406

writing-plans

Use when you have a spec or requirements for a multi-step task, before touching code

Category: Docs & Writing
Source: obra/superpowers · 301,947 stars
License: MIT
Proof model: claude-opus-5-5
Brief: “Write the implementation plan for adding team accounts to a solo-user invoicing SaaS (Next.js, Postgres, Stripe): users must be able to create a team, invite members by email, assign owner or member roles, and share clients and invoices within the team, with billing moving from the user to the team. Present the plan as a single HTML page.”
Skill commit: bb92a77

We don’t pick a winner for you: the pages are the evidence. Both proofs can be repeated with the brief, model and commit shown above. See alternatives to changelog-generator or alternatives to writing-plans.