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/voice.md

View on GitHub
Contract: brand-contract v1
Voice pack: <pack id from voice-packs.md, or `custom`>
Locales: <en (primary)>
Locale parity threshold: 80%
Derived-from: <P-NN, JTBD-NN from docs/ux/foundation.md, or `inferred`>
Status: draft
Last calibrated: <YYYY-MM-DD>
Humanization: on                    # on | off; on is the default, off needs a reason below
Humanization pass: <own | humanizer | avoid-ai-writing>   # optional; absent = own

# Voice

The pack was the starting position. This file is the truth.

## Axes

The five axes are fixed. A project sharpens the wording; it does not add or
remove an axis, because `channels.md` expresses every register as a delta
against exactly these five.

| Axis | The product IS | The product IS NOT |
|---|---|---|
| Confidence | <…> | <…> |
| Register | <…> | <…> |
| Distance | <…> | <…> |
| Humor | <…> | <…> |
| Density | <…> | <…> |

## Narrative

```
Hero:         <who the reader is, in the role this product meets them in>
Enemy:        <the state of the world that costs them, not a competitor>
Product role: <instrument | guide | weapon>
Promise:      <one line, checkable against a row in facts.md>
```

## Invariant in every language

What survives translation. Breaking one of these is a finding on any surface,
in any locale.

- No em dash (U+2014) in new text, in any language; the grammatical Russian
  dash only where no rewrite reads naturally (owner decision, 2026-10-18)
- <e.g. never hedges>
- <e.g. never claims a number that is not in facts.md>

## Reconsidered per locale

Conventions rather than character. Each is decided again in
`locales/<code>.md`.

- address form
- humor level
- idiom and wordplay
- <…>

## Failure mode

Copied from the pack, kept here so the audit can look for it by name.

<the degenerate form this voice collapses into when overdone>

## Voice references

<!-- Two fixed points. The refused one does most of the work: it is the only
half that can be checked against a draft out loud ("this is the thing we said
we would never sound like"). Required once Status leaves `draft`. -->
- **Admired:** <brand or product, and the ONE thing it does that you want>
- **Refused:** <brand or product, and the ONE thing it does that you refuse>
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