changelog-writer

Write changelogs in Vercel and Cursor style and grade drafts against measured prose statistics.

8|1|Updated Feb 17, 2026
One-click install
npx skills add https://github.com/jaredpalmer/skills --skill changelog-writer-jaredpalmer
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: changelog-writer
Source: https://github.com/jaredpalmer/skills/tree/main/changelog-writer
Command: npx skills add https://github.com/jaredpalmer/skills --skill changelog-writer-jaredpalmer

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve? Drafting release notes that match a specific product voice is subjective and hard to verify. This Skill replaces intuition with measurement: it writes changelogs in the Vercel/Cursor house style and grades each draft against a baseline style profile computed from 45 real published changelog entries, iterating until the numbers match. ## Core Features & Use Cases - Style-Grounded Drafting: Encodes the qualitative rules of Vercel and Cursor changelogs — short declarative sentences, second person, present tense, minimal em-dashes, no exclamation marks, bullet-heavy detail. - Quantitative Grading Loop: The stdlib-only Python script scripts/style_profile.py measures sentence length (median/p95), punctuation density per 100 words, fragment and long-sentence percentages, pronoun rates, and bullet share, then reports PASS/FAIL per metric against references/baseline_profile.json. - Revision Guidance: Each failing metric maps to a concrete editing instruction (split compound sentences, reframe around "you", move detail into bullets), with a loop capped at ~4 rounds. - Use Case: A developer tools team shipping instant rollbacks asks for a changelog entry; the Skill drafts it, grades it against the baseline, revises failing metrics, and delivers prose statistically indistinguishable from a real Vercel announcement. ## Quick Start Ask the AI to write a changelog entry for your feature in the style of Vercel or Cursor and iterate until the style grader passes.

Frequently Asked Questions about changelog-writer

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I write release notes that sound like Vercel or Cursor?▼

Draft the entry with the substance first, then run scripts/style_profile.py in grade mode against references/baseline_profile.json. Revise whichever metrics fail — sentence length, em-dash density, second-person rate, bullet share — and re-grade until the report passes.

How to measure writing style of a changelog with Python?▼

Use scripts/style_profile.py, a stdlib-only Python tool. Its profile mode computes a style profile from reference texts, and grade mode compares a draft to that baseline using median and p95 statistics plus per-100-word punctuation densities.

What writing style do Vercel and Cursor changelogs use?▼

Short declarative paragraphs (median one sentence), ~16-word median sentences, second person present tense, almost no em-dashes, zero exclamation marks or questions, and about a third of lines as bullets. Specific numbers and outcomes lead; pitches and effort framing are avoided.

Does the style grader require external Python packages?▼

No. scripts/style_profile.py uses only the Python standard library (argparse, json, re, pathlib). It runs with python3 directly and needs no pip installs or network access.

What if my changelog draft keeps failing one style metric?▼

Use the --allow-failures N flag to pass with up to N out-of-tolerance metrics, or adjust per-metric tolerances in the TOLERANCES dict. The Skill caps revision at about four rounds and then shows the best draft with the grader report for a final human call.