Skip to content

ssheleg/super-ux / plugins/super-ux/skills/brand-voice

brand-voice

Verified

Use when defining or checking how a product speaks: tone of voice, terminology, canonical facts, register. Triggers: "tone of voice" / "тон оф войс", "brand voice" / "голос бренда", "брендбук", "наша терминология". Not for writing the text (copywriting). Refusal phrase "no brand" / «без бренда».

templates/brand/channels.md

View on GitHub
Contract: brand-contract v1

# Channels

One record per surface. `Register` is deltas against the five axes in
`voice.md`: a register moves the axes, never the invariants.

`Forbidden` always carries both halves, even when one is `none`. Platform
physics and brand choice written on one line become indistinguishable within
a quarter, and then nobody can tell which is safe to revisit when the
platform changes.

Delete the surfaces this product does not have. Do not rename one: the
linter and the audit address surfaces by the names in the contract.

---

## Product surfaces

### primary action

```
Register:   <humor -1>
Format:     <verb phrase naming the outcome; one primary per screen>
Limits:     <24 characters>
Forbidden:  physics: none | brand: <"Submit", "OK", bare nouns>
CTA:        <this surface is the CTA>
Proof:      none
Locales:    <coefficient applies to the character limit>
```

### error

```
Register:   humor -3, density +1, distance -1
Format:     what happened, what was not affected, one next step
Limits:     <…>
Forbidden:  physics: none | brand: humor, "unexpected", blame, bare codes
CTA:        the recovery action
Proof:      none
Locales:    <…>
```

### empty state

```
Register:   <unchanged>
Format:     what belongs here, why it is worth it, the one starting action
Limits:     <…>
Forbidden:  physics: none | brand: apology, "Nothing here yet" alone
CTA:        one
Proof:      none
Locales:    <…>
```

### paywall and upgrade

```
Register:   humor -3, distance +1
Format:     what is sold, what it costs, what happens at term end, how to leave
Limits:     <…>
Forbidden:  physics: none | brand: humor, manufactured urgency, hidden terms
CTA:        one primary, one way out
Proof:      one sourced figure
Locales:    <legal differences per locale>
```

### destructive confirm

```
Register:   humor -3
Format:     object, consequence, reversibility; verb repeats the action
Limits:     <…>
Forbidden:  physics: none | brand: humor, "OK" as the confirming verb
CTA:        the destructive verb
Proof:      none
Locales:    <…>
```

<add the remaining product surfaces this product has: loading,
success/toast, onboarding, billing and receipts, settings and legal,
transactional email and push, docs and help>

---

## Marketing surfaces

### landing hero

```
Register:   confidence +1, density -1
Format:     one headline, one subhead, one primary action
Limits:     title 60, meta description 160
Forbidden:  physics: none | brand: superlatives with no facts.md row
CTA:        one, verb plus outcome
Proof:      one number, sourced
Locales:    <coefficient applies to both limits>
```

### X

```
Register:   density +1, distance -1
Format:     one idea; threads 5-12 posts, each standing alone
Limits:     280
Forbidden:  physics: link in body (practice; unverified in the open ranker) | brand: <engagement bait, fake urgency>
CTA:        <in the first reply, not the post>
Proof:      <one figure, sourced>
Locales:    <…>
```

### Instagram

```
Register:   distance -1
Format:     a caption; the first line is the window the feed shows
Limits:     body 2200
Forbidden:  physics: link in body, max 5 hashtags, fold 125, one ask | brand: <engagement bait>
CTA:        one, spoken in the video as well
Proof:      <one figure, sourced>
Locales:    <…>
```

### short video

```
Register:   distance -1, density +1
Format:     hook triple (frame 0, on-screen text, first line), body, one ask
Limits:     <running time; Russian and other locales timed by reading aloud>
Forbidden:  physics: none | brand: <fabricated testimonials, unlabelled synthetic people>
CTA:        one, or a loop back to the first line
Proof:      <one figure, sourced>
Locales:    <…>
```

### Reddit

```
Register:   distance -2, humor +1
Format:     a statement, not a headline; the comments are the content
Limits:     <per subreddit>
Forbidden:  physics: <subreddit rules outrank everything here>
            | brand: undisclosed affiliation, CTA of any kind
CTA:        none
Proof:      <first-hand only>
Locales:    <…>
```

<add the remaining marketing surfaces this product uses: landing body,
pricing, blog, changelog, TikTok, YouTube Shorts, LinkedIn, HN and Product
Hunt, App Store, Google Play, ads, lifecycle email>
slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack."Stars: 198kUpdated Claude CodeCodexVerifiedInstall
ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read.Stars: 196kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 196kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt.Stars: 196kUpdated Claude CodeCodexVerifiedInstall