Styleseed ss-copy

Generate UX microcopy (button labels, error messages, empty states, toasts) following a casual-but-polite voice and tone

install
source · Clone the upstream repo
git clone https://github.com/bitjaru/styleseed
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/bitjaru/styleseed "$T" && mkdir -p ~/.claude/skills && cp -r "$T/engine/.claude/skills/ss-copy" ~/.claude/skills/bitjaru-styleseed-ss-copy && rm -rf "$T"
manifest: engine/.claude/skills/ss-copy/SKILL.md
source content

UX Microcopy Generator

Context: $0 Description: $ARGUMENTS

Instructions

  1. Read the design language reference:

    • DESIGN-LANGUAGE.md
      sections on Microcopy Tone Guide and UX Writing
  2. Apply the voice principles:

Tone Rules

  • Casual but polite: Friendly, not robotic. Like talking to a helpful friend.
  • Active voice: "We saved your changes" not "Your changes have been saved"
  • Positive framing: "Free shipping on orders over $30" not "Orders under $30 have shipping fees"
  • Plain language: "Send money" not "Initiate transfer"
  • Concise: Every word must earn its place

Copy Patterns by Context

Button Labels (CTA)

Format: [Action verb] + [Object] (optional)
Good: "Place order", "Get started", "Save changes", "Try again"
Bad:  "Submit", "OK", "Click here", "Proceed to next step"
  • One primary CTA per screen
  • Label must clearly describe what happens next
  • Max 3 words for primary CTA

Empty States

Format: [Friendly observation] + [Suggested action]
Good: "No activity yet. Create your first project to get started."
Bad:  "No data found."
  • Always suggest a next action
  • Use a relevant icon (32px, text-text-tertiary)
  • Tone: encouraging, not blaming

Error Messages

Format: [What happened] + [What to do]
Good: "Couldn't load the data. Please try again."
Bad:  "Error 500: Internal Server Error"
  • Never show technical errors to users
  • Blame the system, not the user
  • Always provide a recovery action

Toast Notifications

Format: [Confirmation of what happened]
Good: "Saved!", "Changes applied", "Item deleted · Undo"
Bad:  "Operation completed successfully"
  • Max 2 lines
  • Include "Undo" link for reversible destructive actions
  • Info toasts: 3 seconds. Action toasts: 5 seconds.

Form Labels & Helpers

Label: Noun phrase ("Email address", "Password")
Placeholder: Example or hint ("name@example.com")
Helper: Format guidance ("Must be at least 8 characters")
Error: Specific issue ("This email is already registered")

Confirmation Dialogs

Title: [Question about the action]
Body: [Consequence explanation]
Primary: [Action verb] ("Delete", "Confirm")
Secondary: "Close" (not "Cancel" — avoids confusion)
  1. Generate copy for the requested context, providing:
    • Primary copy (what to display)
    • Variants (if context varies)
    • Do's and Don'ts for the specific context