Editorial Voice
Installation
$ npx skills add Mihirmodi27/product-management-skills --skill editorial-voiceSummary
Apply a specific, recognizable writing voice to blogs, articles, thought-leadership pieces, and other long-form content.
Fires when
Use this skill whenever the user asks to write a blog, draft an article, write a post in “the usual style” or “my style,” continue a content series, or rewrite existing content to match a consistent voice. Trigger it even when the user only says “write a blog about X” or “make this sound like our other posts,” since the goal is to keep every piece sounding like the same author with merged substantial paragraphs, accessible-but-credible language, one governing metaphor, contrast and parallel structure, and an ending that elevates from benefit to principle.
SKILL.md
A reusable voice for blogs and long-form content. Apply these rules to any topic so every piece reads like the same author wrote it. The voice is plain, confident, and human: the way a sharp colleague explains something, not the way a brochure sells it.
Paragraph Rhythm
Write in substantial, merged paragraphs. Do not stack one and two-line paragraphs on top of each other, since that fragments the argument into choppy beats and drains momentum. Group related thoughts into a single block so each paragraph carries a complete idea from start to finish. A paragraph should feel defined and whole, not like scattered notes.
Accessibility With Credibility
Write so a non-expert keeps reading and an expert still nods. Introduce technical terms gently, in plain context, rather than assuming the reader already knows them. A newcomer should never feel lost, and a specialist should never feel talked down to. The test is that both finish the piece convinced the writer knows the subject inside and out.
One Governing Metaphor
Choose a single strong metaphor and carry it all the way through the piece. Do not switch metaphors halfway or pile several on top of each other. A consistent image gives the whole piece a backbone and makes the core idea sticky and easy to remember. The earlier example of an "Organizational MRI" carried one body-and-diagnosis metaphor from title to final line, which is the pattern to follow.
Contrast and Parallel Structure
Lean on contrast and repetition as rhythm tools. Use sharp either-or framings to sharpen a point, often as section headers (for example, a header that pits one idea directly against another). Use repeated sentence openings, such as starting several consecutive sentences the same way, to build momentum through a list of ideas. Parallel structure makes points land harder and reads with a confident cadence.
Elevate the Ending
Always close by lifting the reader from a practical benefit to a bigger idea. Do not end on a feature or a small win. Move from the concrete thing the reader gains to the larger worldview or principle behind it. The final line should feel quotable, like a principle worth remembering rather than a summary.
Hard Rules
- Never use em-dashes.
- Keep language simple and clear unless the topic genuinely calls for something denser.
- No filler, no buzzword stacking, no hollow claims.
Applying to a Series
When writing multiple pieces meant to feel related, hold all of the above constant and vary only the topic and the governing metaphor. The consistent rhythm, accessibility, contrast structure, and elevated endings are what make separate pieces read as one body of work.
