Brand Guidelines
Write user-facing copy following Sentry's brand guidelines.
When to Use
- You need to write or rewrite user-facing copy in Sentry's voice.
- The task involves UI text, onboarding, empty states, docs, marketing copy, or other branded content.
- You need guidance on when to use Plain Speech versus Sentry Voice.
Tone Selection
Choose the appropriate tone based on context:
| Use Plain Speech |
Use Sentry Voice |
| Product UI (buttons, labels, forms) |
404 pages |
| Documentation |
Empty states |
| Error messages |
Onboarding flows |
| Settings pages |
Loading states |
| Transactional emails |
"What's New" announcements |
| Help text |
Marketing copy |
Default to Plain Speech unless the context specifically calls for personality.
Plain Speech (Default)
Plain Speech is clear, direct, and functional. Use it for most UI elements.
Rules
- Be concise - Use the fewest words needed
- Be direct - Tell users what to do, not what they can do
- Use active voice - "Save your changes" not "Your changes will be saved"
- Avoid jargon - Use simple words users understand
- Be specific - "3 errors found" not "Some errors found"
Examples
| Instead of |
Write |
| "Click here to save your changes" |
"Save" |
| "You can filter results by date" |
"Filter by date" |
| "An error has occurred" |
"Something went wrong" |
| "Please enter a valid email address" |
"Enter a valid email" |
| "Are you sure you want to delete?" |
"Delete this item?" |
Sentry Voice
Sentry Voice adds personality in appropriate moments. It's empathetic, self-aware, and occasionally snarky.
Principles
- Empathetic snark - Direct frustration at the situation, never the user
- Self-aware - Acknowledge the absurdity of software
- Fun but functional - Personality should enhance, not obscure meaning
- Earned moments - Only use when users have time to appreciate it
Examples
404 Pages:
"This page doesn't exist. Maybe it never did. Maybe it was a dream. Either way, let's get you back on track."
Empty States:
"No errors yet. Enjoy this moment of peace while it lasts."
Onboarding:
"Let's get your first error. Don't worry, it's not as scary as it sounds."
Loading States:
"Crunching the numbers..."
"Fetching your data..."
When NOT to Use Sentry Voice
- Error messages (users are frustrated)
- Settings pages (users are focused)
- Documentation (users need information)
- Billing/payment flows (users need trust)
General Rules
Spelling and Grammar
- Use American English spelling (color, not colour)
- Use Title Case for headings and page titles
- Use Sentence case for body text, buttons, and labels
Punctuation
- No exclamation marks in UI text (exception: celebratory moments)
- No periods in short UI labels or button text
- Use periods in complete sentences and help text
- No ALL CAPS except for acronyms (API, SDK, URL)
Word Choices
| Avoid |
Prefer |
| Please |
(omit) |
| Sorry |
(be specific about the problem) |
| Error occurred |
Something went wrong |
| Invalid |
(explain what's wrong) |
| Success! |
(describe what happened) |
| Oops |
(be specific) |
Dash Usage
| Type |
Use |
Example |
| Hyphen (-) |
Compound words, ranges |
"real-time", "1-10" |
| En-dash (--) |
Ranges, relationships |
"2023--2024", "parent--child" |
| Em-dash (---) |
Interruption, emphasis |
"Errors---even small ones---matter" |
In most UI contexts, use hyphens. Reserve en-dashes for date ranges and em-dashes for longer prose.
UI Element Guidelines
Buttons
- Use action verbs: "Save", "Delete", "Create"
- Be specific: "Create Project" not just "Create"
- Max 2-3 words when possible
- No periods or exclamation marks
Error Messages
- Say what happened
- Say why (if helpful)
- Say what to do next
Good: "Could not save changes. Check your connection and try again."
Bad: "Error: Save failed."
Empty States
- Explain what would normally be here
- Provide a clear action to populate the state
- Sentry Voice is appropriate here
Good: "No projects yet. Create your first project to start tracking errors."
Confirmation Dialogs
- Make the action clear in the title
- Explain consequences if destructive
- Use specific button labels ("Delete Project", not "OK")
Tooltips and Help Text
- Keep under 2 sentences
- Explain the "why", not just the "what"
- Link to docs for complex topics
Anti-Patterns
Avoid these common mistakes:
- Robot speak: "Item has been successfully deleted" -> "Deleted"
- Passive voice: "Changes were saved" -> "Changes saved"
- Unnecessary words: "In order to" -> "To"
- Hedging: "This might cause..." -> "This will cause..."
- Double negatives: "Not unlike..." -> "Similar to..."
- Marketing speak in UI: "Supercharge your
1---2name: brand-guidelines3description: Write copy following Sentry brand guidelines. Use when writing UI text, error messages, empty states, onboarding flows, 404 pages, documentation, marketing copy, or any user-facing content. Covers bot4category: Document Processing5source: antigravity6tags: [api, ai, workflow, document, cro, marketing]7url: https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/brand-guidelines8metadata:9 source: https://skillmd.com/skills/sickn33/brand-guidelines10---111213# Brand Guidelines1415Write user-facing copy following Sentry's brand guidelines.1617## When to Use18- You need to write or rewrite user-facing copy in Sentry's voice.19- The task involves UI text, onboarding, empty states, docs, marketing copy, or other branded content.20- You need guidance on when to use Plain Speech versus Sentry Voice.2122## Tone Selection2324Choose the appropriate tone based on context:2526| Use Plain Speech | Use Sentry Voice |27|------------------|------------------|28| Product UI (buttons, labels, forms) | 404 pages |29| Documentation | Empty states |30| Error messages | Onboarding flows |31| Settings pages | Loading states |32| Transactional emails | "What's New" announcements |33| Help text | Marketing copy |3435**Default to Plain Speech** unless the context specifically calls for personality.3637## Plain Speech (Default)3839Plain Speech is clear, direct, and functional. Use it for most UI elements.4041### Rules42431. **Be concise** - Use the fewest words needed442. **Be direct** - Tell users what to do, not what they can do453. **Use active voice** - "Save your changes" not "Your changes will be saved"464. **Avoid jargon** - Use simple words users understand475. **Be specific** - "3 errors found" not "Some errors found"4849### Examples5051| Instead of | Write |52|------------|-------|53| "Click here to save your changes" | "Save" |54| "You can filter results by date" | "Filter by date" |55| "An error has occurred" | "Something went wrong" |56| "Please enter a valid email address" | "Enter a valid email" |57| "Are you sure you want to delete?" | "Delete this item?" |5859## Sentry Voice6061Sentry Voice adds personality in appropriate moments. It's empathetic, self-aware, and occasionally snarky.6263### Principles64651. **Empathetic snark** - Direct frustration at the situation, never the user662. **Self-aware** - Acknowledge the absurdity of software673. **Fun but functional** - Personality should enhance, not obscure meaning684. **Earned moments** - Only use when users have time to appreciate it6970### Examples7172**404 Pages:**73> "This page doesn't exist. Maybe it never did. Maybe it was a dream. Either way, let's get you back on track."7475**Empty States:**76> "No errors yet. Enjoy this moment of peace while it lasts."7778**Onboarding:**79> "Let's get your first error. Don't worry, it's not as scary as it sounds."8081**Loading States:**82> "Crunching the numbers..."83> "Fetching your data..."8485### When NOT to Use Sentry Voice8687- Error messages (users are frustrated)88- Settings pages (users are focused)89- Documentation (users need information)90- Billing/payment flows (users need trust)9192## General Rules9394### Spelling and Grammar9596- Use **American English** spelling (color, not colour)97- Use **Title Case** for headings and page titles98- Use **Sentence case** for body text, buttons, and labels99100### Punctuation101102- **No exclamation marks** in UI text (exception: celebratory moments)103- **No periods** in short UI labels or button text104- **Use periods** in complete sentences and help text105- **No ALL CAPS** except for acronyms (API, SDK, URL)106107### Word Choices108109| Avoid | Prefer |110|-------|--------|111| Please | (omit) |112| Sorry | (be specific about the problem) |113| Error occurred | Something went wrong |114| Invalid | (explain what's wrong) |115| Success! | (describe what happened) |116| Oops | (be specific) |117118## Dash Usage119120| Type | Use | Example |121|------|-----|---------|122| Hyphen (-) | Compound words, ranges | "real-time", "1-10" |123| En-dash (--) | Ranges, relationships | "2023--2024", "parent--child" |124| Em-dash (---) | Interruption, emphasis | "Errors---even small ones---matter" |125126In most UI contexts, use hyphens. Reserve en-dashes for date ranges and em-dashes for longer prose.127128## UI Element Guidelines129130### Buttons131132- Use action verbs: "Save", "Delete", "Create"133- Be specific: "Create Project" not just "Create"134- Max 2-3 words when possible135- No periods or exclamation marks136137### Error Messages1381391. Say what happened1402. Say why (if helpful)1413. Say what to do next142143**Good:** "Could not save changes. Check your connection and try again."144**Bad:** "Error: Save failed."145146### Empty States1471481. Explain what would normally be here1492. Provide a clear action to populate the state1503. Sentry Voice is appropriate here151152**Good:** "No projects yet. Create your first project to start tracking errors."153154### Confirmation Dialogs155156- Make the action clear in the title157- Explain consequences if destructive158- Use specific button labels ("Delete Project", not "OK")159160### Tooltips and Help Text161162- Keep under 2 sentences163- Explain the "why", not just the "what"164- Link to docs for complex topics165166## Anti-Patterns167168Avoid these common mistakes:169170- **Robot speak:** "Item has been successfully deleted" -> "Deleted"171- **Passive voice:** "Changes were saved" -> "Changes saved"172- **Unnecessary words:** "In order to" -> "To"173- **Hedging:** "This might cause..." -> "This will cause..."174- **Double negatives:** "Not unlike..." -> "Similar to..."175- **Marketing speak in UI:** "Supercharge your