ssheleg/super-ux / plugins/super-ux/skills/brand-voice
brand-voice
VerifiedUse 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" / «без бренда».
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 7.8 KB |
| references/ai-tells.md | markdown | 20.6 KB |
| references/brand-contract.md | markdown | 25.4 KB |
| references/channel-playbooks.md | markdown | 20.0 KB |
| references/hooks.md | markdown | 26.4 KB |
| references/localization.md | markdown | 5.2 KB |
| references/marketing-copy.md | markdown | 8.1 KB |
| references/research-outliers.md | markdown | 5.4 KB |
| references/seo-aeo-safety.md | markdown | 9.9 KB |
| references/store-copy.md | markdown | 7.4 KB |
| references/surface-registers.md | markdown | 9.1 KB |
| references/system-map.md | markdown | 12.4 KB |
| references/video-script.md | markdown | 14.6 KB |
| references/voice-packs.md | markdown | 15.9 KB |
| templates/brand/README.md | markdown | 2.3 KB |
| templates/brand/channels.md | markdown | 4.2 KB |
| templates/brand/copy-brief.md | markdown | 187 B |
| templates/brand/facts.md | markdown | 1.3 KB |
| templates/brand/locale.md | markdown | 2.2 KB |
| templates/brand/strings.md | markdown | 1.7 KB |
| templates/brand/terminology.md | markdown | 1.2 KB |
| templates/brand/voice.md | markdown | 2.2 KB |
templates/brand/README.md
View on GitHubContract: brand-contract v1
# docs/brand/: how this product speaks
`docs/ux/` decides **what the product does**. This folder decides **how it
speaks**: in the interface, on the landing page, in the store listing, in a
post. One voice, many registers.
Owned by the `brand-voice` skill. Written by `copywriting`. Checked by
`python3 docs/brand/lint.py` and by `/ux-audit copy`.
| File | Holds |
|---|---|
| `voice.md` | the identity: pack, five axes, narrative, invariants |
| `terminology.md` | our words, banned words, entity and tier names |
| `facts.md` | canonical numbers and proof, the only source of a figure |
| `channels.md` | one record per surface: register, limits, bans |
| `copy-brief.md` | current marketing task inputs; unknowns stay explicit |
| `strings.md` | interface string registry → `file:line` → scenario |
| `locales/<code>.md` | per-locale delta |
## Sources
**Fill this in before anything else.** The linter scans nothing outside these
paths, and refuses to report a clean run over a surface it never read
(`B006` for no block, `B009` for an unmatched glob). Delete the keys this project does not have: a declared-but-absent
source is worse than an omitted one.
```
Sources:
ui: src/**/*.{ts,tsx,js,jsx,vue,svelte}
marketing: content/**/*.{md,mdx}
store: store/{ios,android}/*.md
robots: public/robots.txt
locales: src/locales/*.json
```
For a website, list the HTML under `marketing` or retain heading markers in a
copy projection. Flat paragraphs cannot prove heading coverage. To make the
no-title-period rule a required gate, run the resolved brand linter with
`--fail-on B063`; default warnings remain advisory. The placeholder source
patterns above must be replaced before the first real lint run.
`ui` and `marketing` also classify findings: several checks apply to only
one of the two.
## The hard rule
Any change to public-facing text updates this folder in the same change, and
`python3 docs/brand/lint.py` exits clean before the work is called done.
## Commands
| Command | Does |
|---|---|
| `/brand` | status across every file, then one recommended action |
| `/brand-init` | pick a voice pack and calibrate it to this product |
| `/brand-update` | recalibrate after positioning or personas changed |
| `/brand-lint` | run the linter |
| `/copy` | write or edit copy for a named surface |
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| 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: 198k | Updated | Claude CodeCodex | Verified | Install |
| 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: 196k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |
| 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: 196k | Updated | Claude CodeCodex | Verified | Install |