SKILL.md
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.