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

View on GitHub
Contract: 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 |
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