Overview
Write clear, useful content in the actual author's voice. Apply this to drafting and revision across posts, replies, articles, and scripts; platform skills provide local format and participation rules. These are editorial practices, not a test of whether a human or AI wrote something.
Mental model
Professional voice comes from a definite point, credible detail, and respect for the reader. Natural writing can be formal, conversational, technical, or concise. It does not require slang, mistakes, dramatic rhythm, or a story about the speaker.
Establish the brief
- Identify the speaker, intended reader, task, venue, and source material. Use approved samples to understand register, terminology, humor, and level of detail; don't copy another person's identity or invent a persona.
- With no voice samples, use clear, restrained prose and the supplied facts. Missing samples do not block an ordinary draft. Missing evidence blocks the unsupported claim.
- Preserve numbers, names, quotations, dates, technical terms, conditions, and uncertainty. A polished sentence must not make the claim stronger.
- First person is appropriate for experience or decisions the speaker supplied. Researching a product does not authorize “I tested it.” Don't invent customers, struggle, excitement, vulnerability, or quotations to create personality.
Write for the reader
- Lead with the useful fact, observation, answer, or decision. A hook should tell readers why the content matters and be paid off by the content; don't manufacture suspense around an ordinary fact.
- Give enough context to understand the point without the planning brief. Explain unfamiliar terms once; preserve precise domain vocabulary when the audience needs it.
- Prefer concrete verbs and identifiable actors. Replace “a transformative solution” with what it actually does, if known. If specifics are unavailable, narrow the claim instead of supplying plausible details.
- Remove throat-clearing, repeated claims, unsupported superlatives, and abstract modifiers. Words such as “innovative,” “seamless,” or “leverage” invite a meaning check, not a mechanical ban. Literal or technical uses may be correct.
- Keep terminology consistent. Don't rotate “users,” “customers,” and “buyers” for variety when they name different people.
- State an evidenced position clearly; keep real qualifications. “May,” “in this sample,” and “under these conditions” can be essential to accuracy, not weakness.
Rhythm and structure
- Read for comprehension and natural emphasis. Split an overloaded sentence or join choppy ones when it improves the logic. Don't enforce sentence-length alternation, contraction percentages, fragments, or punctuation quotas.
- Contractions, fragments, lowercase, and slang should fit the author's register and venue. Correct accidental errors; never add typos, fake edit notes, broken grammar, or invented dialect as camouflage.
- Use active voice when it clarifies responsibility; passive voice is useful when the actor is unknown or the process/result deserves focus.
- Treat repeated contrast slogans, padded adjective lists, staccato paragraph stacks, and compulsory morals as review prompts. Keep a real comparison, a meaningful list of three, or a useful summary.
- Use questions when their answers matter, not as automatic openers or “Agree?” endings. End after the point, a useful next action, or an unresolved question grounded in the subject; no mandatory twist or inspirational closer.
- Use headings, lists, and tables when they help readers navigate or compare. A technical reply may need steps or code; a brief conversational reply usually needs prose. Length and formatting follow the task, not an authorship stereotype.
Platform adaptation and trust
- Adapt the same factual core to each venue's reader intent and medium. A narrated demo, a support reply, and a professional announcement need different context and pacing; changing a few synonyms is not adaptation.
- Read the parent post and relevant replies before answering. Add a specific answer or respectful correction; skip empty praise, imitation of the speaker, and unrelated promotion.
- Give a legitimate CTA only when useful. Asking a real question or inviting a relevant action is different from manufactured engagement, false urgency, or a promised reward that cannot be delivered.
- Keep commercial affiliation and required provenance disclosures visible. For US-facing endorsements, FTC guidance requires truthful experience and clear material-connection disclosures; platform controls alone may not communicate the relationship sufficiently. Check applicable local and platform rules.
- Keep alt text descriptive and faithful to visible information; retain material chart labels or provide equivalent explanation. Review captions for names, negation, numbers, and timing. Accessibility fields are not keyword dumps or extra sales copy.
- For another language, match local register and meaning rather than translating English catchphrases literally. Use contextual evidence or qualified review for uncertain idiom; low search frequency is not proof that a phrase is wrong.
Examples
Illustrative source facts: a product exports CSV; importing CSV is not supported.
Before:
This revolutionary update unlocks seamless data freedom.
After:
You can export your data as CSV. CSV import isn't supported.
The rewrite adds only the stated capability and limitation. It does not invent a user result.
Illustrative source: the author's team tested one repository; runtime was not measured.
Avoid:
We made every workflow dramatically faster.
Use:
We tested this on one repository. We haven't measured runtime yet.
Checklist
References
Reviewed 2026-09-05. Apply source principles within their stated scope; they do not establish social-platform ranking factors. This is a review date, not a publication/update date for the sources below.
Validated: 2026-09
Re-validate when disclosure or accessibility guidance changes, or house voice guidance is revised.
1---2name: content-voice3description: Professional voice, clear prose, and context-aware editing for posts, replies, articles, and scripts. Preserve author facts and register without formulaic rhetoric or fabricated experience.4license: Apache-2.05---67## Overview89Write clear, useful content in the actual author's voice. Apply this to drafting and revision across posts, replies, articles, and scripts; platform skills provide local format and participation rules. These are editorial practices, not a test of whether a human or AI wrote something.1011## Mental model1213Professional voice comes from a definite point, credible detail, and respect for the reader. Natural writing can be formal, conversational, technical, or concise. It does not require slang, mistakes, dramatic rhythm, or a story about the speaker.1415## Establish the brief1617- Identify the speaker, intended reader, task, venue, and source material. Use approved samples to understand register, terminology, humor, and level of detail; don't copy another person's identity or invent a persona.18- With no voice samples, use clear, restrained prose and the supplied facts. Missing samples do not block an ordinary draft. Missing evidence blocks the unsupported claim.19- Preserve numbers, names, quotations, dates, technical terms, conditions, and uncertainty. A polished sentence must not make the claim stronger.20- First person is appropriate for experience or decisions the speaker supplied. Researching a product does not authorize “I tested it.” Don't invent customers, struggle, excitement, vulnerability, or quotations to create personality.2122## Write for the reader2324- Lead with the useful fact, observation, answer, or decision. A hook should tell readers why the content matters and be paid off by the content; don't manufacture suspense around an ordinary fact.25- Give enough context to understand the point without the planning brief. Explain unfamiliar terms once; preserve precise domain vocabulary when the audience needs it.26- Prefer concrete verbs and identifiable actors. Replace “a transformative solution” with what it actually does, if known. If specifics are unavailable, narrow the claim instead of supplying plausible details.27- Remove throat-clearing, repeated claims, unsupported superlatives, and abstract modifiers. Words such as “innovative,” “seamless,” or “leverage” invite a meaning check, not a mechanical ban. Literal or technical uses may be correct.28- Keep terminology consistent. Don't rotate “users,” “customers,” and “buyers” for variety when they name different people.29- State an evidenced position clearly; keep real qualifications. “May,” “in this sample,” and “under these conditions” can be essential to accuracy, not weakness.3031## Rhythm and structure3233- Read for comprehension and natural emphasis. Split an overloaded sentence or join choppy ones when it improves the logic. Don't enforce sentence-length alternation, contraction percentages, fragments, or punctuation quotas.34- Contractions, fragments, lowercase, and slang should fit the author's register and venue. Correct accidental errors; never add typos, fake edit notes, broken grammar, or invented dialect as camouflage.35- Use active voice when it clarifies responsibility; passive voice is useful when the actor is unknown or the process/result deserves focus.36- Treat repeated contrast slogans, padded adjective lists, staccato paragraph stacks, and compulsory morals as review prompts. Keep a real comparison, a meaningful list of three, or a useful summary.37- Use questions when their answers matter, not as automatic openers or “Agree?” endings. End after the point, a useful next action, or an unresolved question grounded in the subject; no mandatory twist or inspirational closer.38- Use headings, lists, and tables when they help readers navigate or compare. A technical reply may need steps or code; a brief conversational reply usually needs prose. Length and formatting follow the task, not an authorship stereotype.3940## Platform adaptation and trust4142- Adapt the same factual core to each venue's reader intent and medium. A narrated demo, a support reply, and a professional announcement need different context and pacing; changing a few synonyms is not adaptation.43- Read the parent post and relevant replies before answering. Add a specific answer or respectful correction; skip empty praise, imitation of the speaker, and unrelated promotion.44- Give a legitimate CTA only when useful. Asking a real question or inviting a relevant action is different from manufactured engagement, false urgency, or a promised reward that cannot be delivered.45- Keep commercial affiliation and required provenance disclosures visible. For US-facing endorsements, FTC guidance requires truthful experience and clear material-connection disclosures; platform controls alone may not communicate the relationship sufficiently. Check applicable local and platform rules.46- Keep alt text descriptive and faithful to visible information; retain material chart labels or provide equivalent explanation. Review captions for names, negation, numbers, and timing. Accessibility fields are not keyword dumps or extra sales copy.47- For another language, match local register and meaning rather than translating English catchphrases literally. Use contextual evidence or qualified review for uncertain idiom; low search frequency is not proof that a phrase is wrong.4849## Examples5051Illustrative source facts: a product exports CSV; importing CSV is not supported.5253Before:54> This revolutionary update unlocks seamless data freedom.5556After:57> You can export your data as CSV. CSV import isn't supported.5859The rewrite adds only the stated capability and limitation. It does not invent a user result.6061Illustrative source: the author's team tested one repository; runtime was not measured.6263Avoid:64> We made every workflow dramatically faster.6566Use:67> We tested this on one repository. We haven't measured runtime yet.6869## Checklist7071- [ ] The opening delivers a specific point for the intended reader.72- [ ] Every experience, result, and quotation belongs to the stated speaker and source.73- [ ] Edits preserve scope, uncertainty, and technical meaning.74- [ ] Rhythm, formatting, and vocabulary serve comprehension without artificial quotas.75- [ ] Platform participation, disclosure, accessibility, and publication conditions are satisfied.76- [ ] The final copy is separate from internal source notes and unresolved questions.7778## References7980Reviewed 2026-09-05. Apply source principles within their stated scope; they do not establish social-platform ranking factors. This is a review date, not a publication/update date for the sources below.8182- [GOV.UK clear-language guidance](https://guidance.publishing.service.gov.uk/writing-to-gov-uk-standards/writing-guidelines/clear-language/) — a public-service style guide supporting audience-focused clarity, not a universal brand voice.83- [FTC endorsement disclosures](https://www.ftc.gov/business-guidance/resources/disclosures-101-social-media-influencers) — US-facing endorsements and truthful experience.84- [W3C image alternatives](https://www.w3.org/WAI/tutorials/images/decision-tree/) — communicate an image's purpose and relevant information.85- [Google's AI-content guidance](https://developers.google.com/search/docs/fundamentals/using-gen-ai-content) — accuracy and reader value, not guaranteed traffic from “human” style.86- [Fact grounding](../content-grounding/SKILL.md) and [structured revision](../content-humanize/SKILL.md).8788Validated: 2026-098990Re-validate when disclosure or accessibility guidance changes, or house voice guidance is revised.