brand-guidelines

The brand-guidelines skill is a writing reference that helps produce user-facing copy consistent with Sentry's brand voice. It solves the common problem of inconsistent, wordy, or off-tone product text by codifying two distinct tones and a decision table for when each applies: Plain Speech (the clear, direct, functional default for buttons, labels, forms, documentation, error messages, and settings) and Sentry Voice (an empathetic, self-aware, occasionally snarky tone reserved for 404 pages, empty states, onboarding, loading states, and marketing copy).

The skill supplies concrete rules and before/after examples for concision, active voice, jargon avoidance, and specificity, plus general conventions covering American English spelling, Title Case versus Sentence case, punctuation (no exclamation marks or ALL CAPS except acronyms), word choices to avoid, and hyphen/en-dash/em-dash usage. It also gives targeted guidance for UI elements such as buttons, error messages (say what happened, why, and what to do next), empty states, confirmation dialogs, and tooltips, and lists anti-patterns like robot speak, passive voice, hedging, and marketing speak in UI. It links to Sentry's public voice and frontend handbook references.

It is aimed at product designers, frontend engineers, technical writers, and anyone authoring interface text, error messages, onboarding flows, or marketing copy who needs it to read as Sentry. The content is purely a prose/style reference with no scripts, commands, or external calls.