Docs & Writing vs Testing · both proven

changelog-generator vs writing-guidelines

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. They are in different categories, so this is a choice of job, not a head-to-head on the same job.

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
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

Without the skillWith changelog-generator

⇆

Without, runWith changelog-generator, run3 independent runs per side, none selected by hand.

Download the with-skill page

writing-guidelines

Review docs/prose for Writing Guidelines compliance. Use when asked to "review my docs", "check writing style", "audit prose", "review docs voice and tone", or "check this page against the writing handbook".

Category: Testing
Source: vercel-labs/agent-skills
License: Not stated
Proof model: claude-opus-5-5
Brief: “Review and rewrite this getting-started page for Pipewell, a data pipeline CLI. The draft opens with two paragraphs of company history, mixes 'you' and 'the user', buries the install command in the fourth paragraph, uses passive voice throughout, and ends without a next step. Write the improved page as a single HTML document, followed by a short list of what you changed and why.”
Skill commit: 063bee9

Without the skillWith writing-guidelines

⇆

Without, runWith writing-guidelines, run3 independent runs per side, none selected by hand.

Download the with-skill page

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-guidelines.