WR

It adjusts text to remove robotic phrasing and corporate jargon, ensuring UI and documentation remain clear and professional.

Install

mkdir -p .claude/skills/writing-voice && curl -L -o skill.zip "https://agentskills.codes/api/skills/download/1090" && unzip -o skill.zip -d .claude/skills/writing-voice && rm skill.zip

Installs to .claude/skills/writing-voice

Activation

This is the description your AI agent reads to decide when to run this skill — the better it matches your request, the more reliably it fires.

Voice/tone rules for prose, UI text, tooltips, error messages. Use when: "fix the tone", "rewrite this", "sounds like AI", "sounds corporate", or writing user-facing text and docs.
180 chars✓ has a “when” trigger
Intermediate

Key capabilities

  • →Refine prose to sound natural and read-aloud friendly
  • →Identify and remove corporate jargon or AI-shaped phrasing
  • →Adjust sentence length to improve rhythm and nuance
  • →Replace abstract verbs with specific, direct alternatives
  • →Standardize punctuation for spoken movement

How it works

The skill involves reading a draft at speaking speed to identify rhythm catches and generic language. It then replaces abstract verbs and marketing filler with direct, specific vocabulary while preserving the writer's original cadence.

Inputs & outputs

You give it
Draft prose containing generic language or robotic phrasing
You get back
Revised text that sounds like natural human speech

When to use writing-voice

  • →Rewriting technical documentation
  • →Drafting user-friendly UI copy
  • →Fixing robotic error messages
  • →Aligning product copy with a human voice

About this skill

Writing Voice

Help the writing carry recognizable judgment and recognizable sound. Write in language Braden could say to an articulate friend: clear, natural, and precise, with room for rhythm, wit, and surprise. Find phrasing that makes the thought felt as well as understood. Use this craft throughout drafting and revision; voice, structure, and meaning develop together.

Find The Expression

Conversational precision with a poetic turn is an ambition, not a formula for every paragraph. A turn earns its place by revealing a connection in the material. Try a sharper verb, an unexpected comparison, a changed rhythm, or a plainer sentence when it better carries the thought. Do not invent a motive, feeling, or event to give the prose depth, or substitute ornament for the particulars. Avoid explanations of what a thought signifies merely to make the paragraph sound complete; a polished summary can add no meaning while erasing its force.

Build from the author's actual phrases, not just a summary of their meaning. Keep the comparisons, ordinary words, asides, and emphatic turns that make the speaker recognizable; arrange and connect them before replacing them with equally accurate paraphrases. Roughness can carry emotion, humor, tension, uncertainty, or rhythm. “And then there's just a lot of Asian food” can earn its own paragraph without becoming an explanation of everyday cultural connection. Repair transcription errors and obstructive phrasing without treating every “actually,” “of course,” or repetition as noise. Neither roughness nor polish is a virtue by itself.

Choose the register from the piece's purpose and Braden's reactions. Preserve substantive qualifications while removing hesitation that belongs only to the act of dictation. Preserve the degree of conviction too: changing “I would argue” into “I wonder whether” can weaken the thought even when its subject stays the same. Do not strengthen real uncertainty into certainty either. A direct argument can present a position for examination without turning it into his personal belief. Personal writing can remain unresolved without narrating every step of the conversation that produced it.

Hear The Whole Passage

Writing for the ear is part of developing the piece. Listen for how the words carry the thought, giving that attention more weight when the work will be spoken aloud. An “ear pass” names this editorial focus, not a separate workflow. The active writing workflow, such as page-writing or journal-writing, continues to own the conversation and edits.

Read connected passages at speaking speed and judge each sentence with what surrounds it. The four ear tests below guide attention, not a report to fill out. Hear what the writing is doing, then judge it by what this piece needs.

When a reaction reveals a mismatch, rehear the passage under that correction and revise at the scope it illuminates. Use the destination's exploration workflow when contrasting expressions would help; an authorized direct edit needs no options menu. Reread the changed passage in context to hear whether its movement and the author's posture still belong together. After a whole-piece pass, check that the opening, strongest concrete detail, and ending still serve the same thought.

For work intended to be heard, read spoken destinations for the extra judgments a listener's experience requires. Ordinary editing does not impose a narration or social-video standard on every piece.

Economy

Identify what each sentence or paragraph contributes: a claim, example, turn, qualification, emphasis, or the experience of discovering the thought. Try the deletion test: would removing it preserve meaning, movement, and human posture? Look for throat-clearing, doubled qualifiers, repeated explanations, generic connections, or abstract nouns a concrete verb could replace. A sentence can earn its time through hesitation, humor, contrast, or rhythm as well as new information. Cut unearned time, not simply words.

Rhythm

Listen for long clauses, stacked abstractions, repeated openings, awkward mouth-feel, false starts, and phrasing whose predictability drains its force. Hear where a breath naturally belongs and where emphasis lands. Split a sentence when it helps the listener follow, not merely to create short lines. A pause or repetition may build pressure, preserve uncertainty, or make a joke land. Judge the words before trying to fix the delivery or timing.

Movement and progressive disclosure

Trace what the reader or listener encounters in order and what each turn needs. An argument may explain a mechanism, a scene may accumulate particulars, and a question may stay open. An early conclusion can orient the reader; a later one can let the example earn its force. Choose the order this expression needs without imposing suspense, a moral, or a changed meaning at the end.

Human recognition

Ask: “Could the author genuinely have brought this to another person?” Hear whether the concrete details, odd phrasing, humor, uncertainty, and degree of judgment still belong to the author. Remove polish that makes the passage more solemn, certain, universal, or professionally scripted than its intended expression. Recognition matters more than grammatical perfection; shaping the writing should keep the person audible, including in newly discovered language.

Respect The Form

A message, essay, button, and technical explanation have different jobs. Let those jobs shape length and register while keeping the person audible. Clarity does not require corporate scaffolding or false authority.

Use punctuation to make movement legible. Prefer periods. Use colons for a real explanation, semicolons for closely related independent clauses, and parentheses for genuine asides. Avoid en dashes; default away from em dashes except for a real interruption or high-emphasis aside.

When not to use it

  • →When the goal is to maintain corporate or robotic tone
  • →When the document requires rigid template scaffolding

Limitations

  • →Does not determine the document's overall shape or structure
  • →Requires the writer to maintain their own emotional temperature and claim strength

How it compares

Unlike generic editing that focuses on grammar, this approach prioritizes the ear pass to ensure the text sounds like something the writer would naturally say.

Compared to similar skills

writing-voice side by side with the closest alternatives in the catalog.

SkillInstallsUpdatedSafetyDifficulty
writing-voice (this skill)64moNo flagsIntermediate
scientific-writing943moReviewIntermediate
resume-builder534moNo flagsBeginner
humanizer908moNo flagsBeginner

Try saying

Example prompts that trigger this skill in your AI assistant.

You might also like

scientific-writing

K-Dense-AI

Write scientific manuscripts. IMRAD structure, citations (APA/AMA/Vancouver), figures/tables, reporting guidelines (CONSORT/STROBE/PRISMA), abstracts, for research papers and journal submissions.

94309

resume-builder

amruthpillai

Generate professional resumes that conform to the Reactive Resume schema. Use when the user wants to create, build, or generate a resume through conversational AI, or asks about resume structure, sections, or content. This skill guides the agent to ask clarifying questions, avoid hallucination, and produce valid JSON output for https://rxresu.me.

53229

humanizer

davila7

Remove signs of AI-generated writing from text. Use when editing or reviewing text to make it sound more natural and human-written. Based on Wikipedia's comprehensive "Signs of AI writing" guide. Detects and fixes patterns including: inflated symbolism, promotional language, superficial -ing analyses, vague attributions, em dash overuse, rule of three, AI vocabulary words, negative parallelisms, and excessive conjunctive phrases. Credits: Original skill by @blader - https://github.com/blader/humanizer

90175

ux-writing

content-designer

Create user-centered, accessible interface copy (microcopy) for digital products including buttons, labels, error messages, notifications, forms, onboarding, empty states, success messages, and help text. Use when writing or editing any text that appears in apps, websites, or software interfaces, designing conversational flows, establishing voice and tone guidelines, auditing product content for consistency and usability, reviewing UI strings, or improving existing interface copy. Applies UX writing best practices based on four quality standards — purposeful, concise, conversational, and clear. Includes accessibility guidelines, research-backed benchmarks (sentence length, comprehension rates, reading levels), expanded error patterns, tone adaptation frameworks, and comprehensive reference materials.

42155

writing-rap-lyrics

asvskartheek

Helps write rap lyrics with proper rhythm, flow, cadences, and structure. Teaches musical fundamentals (bars, beats, tempo, BPM) and lyric formatting. Use when writing rap lyrics, creating verses, understanding flow, structuring bars, improving cadence, learning rhythm patterns, or formatting rap lyrics.

44143

docs-write

metabase

Write documentation following Metabase's conversational, clear, and user-focused style. Use when creating or editing documentation files (markdown, MDX, etc.).

22139

Search skills

Search the agent skills registry