---

name: microcopy-writer description: "Write the small UI text that guides users — buttons, labels, tooltips, CTAs, confirmations. Use when asked to write microcopy, button/CTA text, form labels, tooltips, helper text, or to make UI wording clearer. Produces specific, action-oriented microcopy with options and rationale, matched to the moment and the product's voice — concise, scannable, and free of jargon."

Microcopy Writer Skill

Microcopy is the smallest text with the biggest leverage: a button label, a field hint, a confirmation. Good microcopy is clear, action-oriented, and reduces hesitation — it tells the user exactly what will happen and what to do. This skill writes that text for a specific moment, with a couple of options and the reasoning, so the team can choose with intent.

Working from a brief

Given "a button for the checkout step" or a screenshot description, write the microcopy anyway — infer the context, the user's goal, and the voice, and label assumptions. Offer 2–3 options where wording is a judgement call. Never hand back a question instead of copy.

Required Inputs

Ask for these only if they aren't already provided (else infer and label):

• The element & moment — what UI element (button, label, tooltip, toast…) and where in the flow.
• The user's goal — what they're trying to do, and what happens when they act.
• Constraints — character limits, the existing voice/tone, and any required terms.
• Stakes — is the action reversible, risky, or final (affects tone and confirmation).

Output Format

Microcopy: [element / moment]

For each piece of text:

• Recommended — the best option, ready to ship.
• Alternatives — 1–2 other options with a different angle (shorter, warmer, more explicit).
• Why — one line: what makes the recommended version work (clarity, the verb, the expectation it sets).

Apply the principles: lead with a verb for actions ("Save changes", not "OK"); say what happens next; keep it short and specific; match voice; and for risky/irreversible actions, make the consequence explicit ("Delete 3 files" beats "Are you sure?"). Cover the related states if relevant (default, loading, success, error).

End with consistency notes — terms/patterns to reuse elsewhere so the product speaks with one voice.

Quality Checks

• Action text leads with a specific verb and sets the right expectation (no bare "OK"/"Submit" when something clearer fits)
• It's concise and scannable — no filler, no jargon
• Risky/irreversible actions state the consequence, not just "Are you sure?"
• Wording matches the product's voice and existing terminology
• Options are given where wording is a real judgement call, each with a one-line rationale
• Related states (loading/success/error) are covered when relevant

Anti-Patterns

• Do not use vague labels ("OK", "Submit", "Click here") when a specific verb communicates the outcome
• Do not write clever copy that obscures what the button does — clarity beats personality at decision points
• Do not ignore character limits or the existing voice — microcopy must fit the UI and the brand
• Do not hide consequences behind a generic confirmation — name what will happen
• Do not invent product terms — reuse the established vocabulary for consistency

Based On

UX writing practice — action-oriented, expectation-setting microcopy, voice consistency, and clarity at decision points.

Example Trigger Phrases

• "Write microcopy for this form."
• "Write button and CTA text."
• "Write tooltips and helper text."
• "Make this UI wording clearer."