К основному содержанию
скилл CX Codex

visant-copy — скилл для Claude Code: что делает и как установить

Скилл visant-copy для Claude Code пишет и правит тексты на pt-BR в голосе Visant, а copy-lint ловит штампы ИИ на pt и en. Запускается на просьбах про заголовок или тон голоса.

MIT ★ 91 обновлён 2026-11-11

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add pedrojaques99/visant-skills-public --skill visant-copy -a claude-code
Открыть на GitHub

Что делает visant-copy

Скилл ведёт тексты на бразильском португальском в голосе Visant: лендинг, статья, подписанный пост. Регистр выбирается до первой фразы — подписанный от «eu» для эссе и рассылок, домашний от «a gente» для лендингов и CTA, интерфейсный из глаголов для кнопок и ошибок.

Внутри десять запретов: тире и точка-разделитель, оборот «não é X, é Y», негатив в хвосте, эмодзи и точка с запятой, клише про последние места, зачины вроде «Imagine que». Слова достоверности вроде «real» или «de verdade» — одно на страницу.

Линтер scripts/copy-lint.mjs работает на обычном node без зависимостей, обходит папки и пропускает сгенерированные файлы. Файлы одной страницы передаются вместе, потому что так виден повтор фразы в двух местах. Предупреждения о длине (заголовок 60, CTA 28, лид 180) идут мимо кода выхода. Правки, которых линтер не просил, приходят таблицей «ключ, было, стало»: файл меняют только по выбору автора, а при явном заказе на переписывание скилл сразу показывает было и стало.

Какие задачи решает

  • переписать первый экран лендинга без штампов ИИ
  • проверить статью на запрещённые конструкции
  • свести заголовки и CTA к одному голосу
  • найти одну и ту же фразу в нескольких файлах страницы
  • отдать правки таблицей, чтобы автор выбрал строки

Примеры запросов агенту

  • Проверь копирайт в page.tsx и покажи таблицу предлагаемых правок.
  • Перепиши заголовок первого экрана в домашнем регистре Visant.
  • Прогони copy-lint по copy.json и разбери, что он нашёл.

Как установить visant-copy

1Через Skills CLI (Vercel)

npx skills add pedrojaques99/visant-skills-public --skill visant-copy -a claude-code

2Вручную: положить файлы

~/.claude/skills/visant-copy/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/visant-copy/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о visant-copy

Как установить visant-copy в Claude Code?

Выполнить npx skills add pedrojaques99/visant-skills-public --skill visant-copy -a claude-code. Файлы скилла окажутся в ~/.claude/skills/visant-copy/SKILL.md.

Что делает visant-copy?

Пишет и проверяет тексты на pt-BR в голосе Visant: от лендинга до подписанного поста. Отдельно запускает copy-lint, который ищет штампы ИИ на португальском и английском.

Что нужно для работы visant-copy?

Node для запуска scripts/copy-lint.mjs; сторонних зависимостей линтеру не нужно. Отчёт по аудиту приходит таблицей, текст в файлах остаётся прежним до выбора строк.

Исходный текст

SKILL.md · MIT
---
name: visant-copy
description: 'Writes, audits and reviews Brazilian Portuguese copy in Visant''s voice, from landing to signed post, and runs copy-lint, which catches AI tics in PT and English. Use on "copy", "headline", "landing copy", "audit the copy", "auditar o copy", "reescrever a dobra", "tirar cara de IA", "burilar a copy", "artigo", "newsletter", "tom de voz".'
metadata:
  family: texto
  routes: visant-headlines
---

# Visant Copy

Two things live here: **how Visant copy sounds** (valid in any repo) and **how it
is operated**, which depends on where the text lives. The voice below is for
Brazilian Portuguese; **for English copy read [english.md](references/english.md)**.
The linter runs a PT and an English rule set on every input.

- **The repo uses Visant's pipeline** (`copy*.json` at the root and
  `copy:build`/`copy:check` scripts in `package.json`): the JSON is the SSoT and
  the HTML is a generated view, so never edit text directly in the `.html`. See
  "If the repo uses Visant's pipeline".
- **Any other repo** (copy inside the component, `.md`, exported CMS): the
  component is the SSoT, and the risk is echo, the same sentence in four files.

Find out which one before touching text:

```bash
ls copy*.json 2>/dev/null; grep -nE '"copy:(lint|build|check)"' package.json
```

Either way, never write Visant copy without going through the prohibitions
below. **Asked to audit a page?** A clean linter says little: follow
[references/audit.md](references/audit.md).

## Pick the register first

The voice is one; who is speaking changes. Decide before the first sentence.

| register | pieces | who speaks | rhythm |
|---|---|---|---|
| **Signed** | essay, newsletter, post, thread, personal invitation | "eu", a named person with an opinion | ~17 words on average, room for a long sentence and a story |
| **House** | landing, product line, CTA, FAQ, sales email | "a gente" or "nossa", speaking for Visant | ~12 words, punch after the long sentence |
| **Interface** | button, label, error, caption | nobody, just the verb | as short as it stays clear |

Signed is where the voice comes from, so read
[the signed register](references/voice.md#8-signed-register-from-the-originals)
before writing anything longer than a section, in any register.

## Rule zero: propose, never apply

**Only the tic fixes the linter points out go into the file.** A headline, lead
or sentence that passes clean stays untouched, even if you think it sounds flat.

Style improvements go as a **proposal table in the report** (key, before, after),
and the user picks row by row. Rewriting what was already good burns trust and
makes the user review the reviewer.

**An audit changes nothing yet.** Asked to audit or review, deliver the table, tics
included, and ask which rows to apply.

**The exception is an explicit request.** "Essa copy tá confusa, tem que ser na
pegada X" is a work order, not an invitation to debate: apply it, show the
before/after table, and leave **one or two ONE-line alternatives** at the end, so
a swap costs one Edit and not a new round. Returning only options when the user
already gave the direction pushes the work back to them.

## The prohibitions

Absolute. They apply to headline, body, CTA, FAQ, email, caption, alt text,
error message, meta description. No "but here it worked" exception. The only
one is rule 3, and context decides it: [a real reversal is not the AI tic](references/voice.md#the-one-exception-a-real-reversal).

1. **Dash (— or –) never.** Period, comma, colon or parentheses.
2. **Separator dot (`·`, alt+7) never.** Not in metadata lists, not in a CTA with
   a price, not in a phase label, not on the social card. In a list it becomes
   period and comma ("34 páginas. 9 etapas, 1 case inteiro"), in a label a colon
   ("Fase 1: A Estratégia"), in a CTA a preposition ("Quero o e-book por R$ 47").
3. **"Não é X, é Y" never.** Not split in two sentences ("Não é uma lista. É uma
   cascata."). Not the sentence that defines by negation ("Não é slogan.").
4. **"É sobre X" never.** It asserts nothing. Swap it for the verb of what the
   thing does.
5. **"Não é apenas X, é X e Y" never.** Nor "mais que apenas", "menos X e mais
   Y", "não se trata de".
6. **Negation dangling at the end never.** "Feito pra ler, não pra arquivar."
   Delete the tail and the sentence gets stronger.
7. **Emoji never. Semicolon never.** (`©`, `®`, `™` are trademarks and stay.)
8. **Guru openings never.** "Imagine que", "E se eu te dissesse", "Prepare-se
   pra", "Chegou a hora de". Start with the fact or the scene.
9. **Cliché urgency never.** "Últimas vagas", "corre que acaba", "por tempo
   limitado". Scarcity must be countable: say the number ("este lote tem 30
   vagas", "a cota sobe a cada compra").
10. **Credibility seal at most once per page.** "real", "de verdade", "na
    prática", "de fato", "genuíno", "autêntico", "honesto". One passes. With two, the reader
    counts and posts a screenshot ("trajetória real, projeto real, técnica real,
    processo real"). An adjective does not prove; numbers and scenes do.
    `Sete anos de projeto real` → `Sete anos entregando marca`.

**The rule that solves 3 to 6: cut the negative half.** The sentence that remains
is almost always the right one. If the contrast really is the argument, show the
**consequence** instead of negating: instead of "não é falta de talento, é falta
de ordem", write "Talento você já tem. O que falta é ordem."

## The linter

Running it before delivering copy is mandatory. Plain node, no dependencies, runs
in any repo:

```bash
L=<skill-dir>/scripts/copy-lint.mjs
node $L copy.json                       # copy JSON
node $L hero.tsx page.tsx og.tsx        # components, passed TOGETHER
node $L README.md docs/landing.md       # markdown or plain text
npm run copy:lint                       # if the repo uses Visant's pipeline
```

Folders are walked, generated files skipped. Inputs, flags and rule ids: [references/linter.md](references/linter.md).

Exit 1 with the key, the excerpt and the fix. Two warnings come **outside the
exit code**, because good copy cannot fail on a detail:

- **length per line type** (headline 60, CTA 28, lead 180, body 280, SEO title
  60, meta description 160), inferred from the key suffix, so `.json` only; it
  flags the headline that breaks into three lines on mobile;
- **echo**, when the same sentence lives in two of the files passed in the same
  call. That is why you **pass the files together**, never one at a time.

In code files **comments are not linted** on purpose: a JSDoc is not copy.

### Repetition budget is per PIECE, and the file is not always the piece

`credibility-seal` (limit 1, PT and EN words share it) counts per piece: in JSON
the first key segment (`onboarding.*`), in a component the file. Money (`R$ 47`)
is not a seal; the rest is semantic, so confirm at `file:line`. [Why](references/cases.md).

## The voice

Pattern taken from Visant's e-book landing and from what the studio publishes
under its own name. In order of importance:

1. **Spoken Brazilian, by ear.** "para" and "pra" both live here: written lines
   lean "para", spoken beats take "pra", "tá", "tô". Never swap one for the other
   mechanically. No "cê", "mano", "tá ligado". Short imperative: "Lê e julga".
2. **Short sentence after short sentence.** Average 12 words. **A verbless
   fragment is a device**, always as a punch after the long sentence: "…e a marca
   se comporta de outro jeito três meses depois. Toda vez."
3. **Scene instead of adjective.** Never "inconsistência de marca". Write what is
   seen: "Um post fala uma coisa, o atendimento fala outra, o site parece de
   outra empresa."
4. **Blame starts with the author, and only if it happened.** Never invent a
   scene, memory or confession: [ask, or mark the place](references/voice.md#never-invent-the-personal-part). Confess before charging: "A gente começava
   pelo logo também. Perdeu semanas assim, até inverter a ordem." Accusing the
   reader directly ("você começa pelo logo porque é a parte divertida") only
   after the confession, if at all.
5. **Raw numbers, not rounded to impress.** `R$450k`, `160+ lives`,
   `34 páginas`, `7 dias`.
6. **Admit limits.** "Se algo não funcionou pra gente, tá escrito que não
   funcionou." It is what most separates the voice from AI text.
7. **Humor by mocking the market**, dry and unsignposted: "Sem aula de 40 horas
   ensinando a centralizar retângulo." It targets the practice, never the person.
8. **Mild swearing, at most one per page**, and only where the argument hurts:
   "porcaria", "cagada". Never in the CTA or the main headline.
9. **Objections in the reader's voice.** The FAQ is what the person thinks, in
   their words: "Já faço branding há anos. Vou ver algo novo?". The answer opens
   by answering ("Serve.", "É."), never with "Ótima pergunta".
10. **Takes a position and owns it.** "Eu acho triste", then "mas não importa se
    eu acho isso bom ou ruim". Grant the best counterargument before answering it.
11. **The specific analogy, announced.** "Um exemplo meio tosco": the Subway order
    with "exatamente 12 azeitonas pretas". Detail too exact to be invented is what
    AI text lacks.

For a long signed piece, follow the skeleton in
[voice.md §9](references/voice.md#9-structure-of-a-signed-piece-the-skeleton). For text that passes the
linter and still reads like AI, hunt the tells in [§10](references/voice.md#10-linguistics-what-makes-it-sound-brazilian).
For a script that will be read aloud, [§11](references/voice.md#11-spoken-scripts-video-narration).

Line-by-line detail, vocabulary, anglicisms, money, CTA, and the before/after
table: [references/voice.md](references/voice.md). Read it before writing a new
piece or rewriting a whole section.

### The fold and the product line: two mistakes invisible to every linter

**The fold (H1, `<title>`, social card) names the TASK, not the state.** State
copy describes the reader's world and leaves them to work out the gain; task
copy names the verb they came to do. Test: **which verb would the reader type
into Google?** Full test, examples and the wrong-task trap:
[voice.md → The fold names the task](references/voice.md#the-fold-names-the-task-not-the-state).

**The product line says what the reader gets**, not the mechanism from inside,
a list of nouns, or a promise the demo beside it contradicts. Full failure
modes: [voice.md → The product line](references/voice.md#the-product-line-says-what-the-reader-gets).

Visant's own brand terms: [glossary](references/voice.md#brand-glossary-visants-own-copy-only). In client copy, the glossary is the client's.

## If the repo uses Visant's pipeline (`copy.json`)

**Copy lives in the JSON. HTML and Markdown are generated views.** Editing text
in the `.html` is always wrong: the next build overwrites it and the check breaks
the deploy. Flow: edit the JSON, `npm run copy:lint`, `npm run copy:build`,
commit json + html + md together (`copy:check` in the gate catches drift). SEO
(`meta.title`, `meta.description`, `meta.og_*`) lives in the JSON too, injected
via `data-copy-attr="content"`.

Full mechanics (new key, new page, `data-copy-attr`, `\n` becoming `<br>`, orphan
key error, setting it up in a new repo): [references/pipeline.md](references/pipeline.md).

## When there is no `copy.json` (any other repo)

**The component is the SSoT.** Do not set up a `copy.json` in the middle of a text
task. The risk changes shape: the same sentence lives in three or four places, so
**after changing the headline, hunt the echoes** with `rg`. The social card and the
`<title>` get forgotten most. Where they hide, and why the `<title>` keeps the search
noun: [references/pipeline.md](references/pipeline.md#without-copyjson-echoes-in-a-component-repo).

## Work order on "review/write the copy"

1. Read the page's whole JSON (or the whole component) before touching any key.
   Including comments: they hold the WHY of the current line, and copy that
   contradicts the decision documented there is rework.
2. Run `copy-lint` to get the map of tics.
3. **Apply only the tic fixes**, and the rewrite the user asked for with a
   direction. Everything else becomes a proposal in a table.
4. Check every number against the source of truth (server-side price, client
   count, member count). The skill does not store those values on purpose: they
   age. When in doubt, ask before publishing.
5. **Hunt the echo** of the old sentence (`rg`, or the linter's echo warning with
   the files passed together) and update the social card, `<title>`, description
   and `alt`.
6. If you touched a code comment, update what it explains: a comment defending
   the old copy lies to the next dev.
7. Run `copy-lint` again. With Visant's pipeline, also `copy:build` and
   `copy:check`. In a React/TS repo, `tsc --noEmit`.
8. Report the before/after of the changed lines. The user approves text by
   reading text, never by reading a summary of the text.

## Neighbors

- **Feedback**: when the work is delivered, ask once per session, in one line, what helped and what was missing; it goes to https://ui.visantlabs.com/skills#feedback
- **[[visant-design]]**: the layout around the words
- **[[visant-killer]]**: a screen that looks AI-made; this skill handles text that reads AI-made
- **[[visant-headlines]]** (Visant internal): a client brand's voice; this skill is Visant's voice
- **[[visant-new-site]]** (Visant internal): the copy of a whole client site
- **[[revenue-centric-design]]**: the lever behind the message; this skill writes the sentence

© pedrojaques99 · MIT · pedrojaques99/visant-skills-public

Похожие скиллы

Все скиллы по теме «Тексты и документация» →
copy raphaelsalaja Скилл copy для Claude Code проверяет и переписывает тексты в интерфейсе. Следит за Title Case в кнопках и меню, убирает длинные описания и тире. CX Codex +1 172установок copywriting-tone-of-voice-creator samber Скилл copywriting-tone-of-voice-creator создаёт гайд по тональности бренда TONE.md или адаптирует его под новые каналы. Пригодится при запуске контент-фабрики или обновлении правил общения с аудиторией. CX Codex +1 5 800установок brand-voice rampstackco Скилл brand-voice помогает составить гайдлайн по тону и голосу бренда с правилами лексики, контекстными сдвигами и парными примерами текста. CX Codex +1 367установок shrek surendranb Скилл shrek переписывает текст в манере Шрека: прямолинейно, с ворчанием, болотными метафорами и скрытой теплотой без слащавости. CX Codex +1 ★ 57звёзд репо copy-editing coreyhaines31 Скилл copy-editing для Claude Code и Codex: редактирует маркетинговые тексты, письма и описания без полной переписки. CX Codex +1 163 900установок website-copy-specialist ncklrs Скилл website-copy-specialist для Claude Code и пяти других платформ: пишет копирайт для страниц SaaS и B2B — главная, тарифы, сравнения, интеграции, микрокопия навигации. Берёт конкретную страницу, а не даёт общие советы. CX Codex +1 582установок

Из того же набора12

Весь набор →
visant-mcp-connect Скилл visant-mcp-connect для Claude Code подключает инструменты Visant Labs через MCP. Он срабатывает на просьбы настроить Visant, вызвать его инструменты или извлечь данные из PDF. CX Codex +1 ★ 91звёзд репо visant-preflight Скилл visant-preflight для Claude Code проводит опрос стейкхолдера и проверяет шрифты, графику и брендбук перед стартом крупных клиентских проектов вроде редизайна сайта или запуска кампании. CX Codex +1 ★ 91звёзд репо visant-video-editor Скилл visant-video-editor для Claude Code собирает видео из исходных материалов: анализирует клипы, предлагает список склеек и готовит ролик. Включается по запросу смонтировать влог, урок или нарезать тишину. CX Codex +1 ★ 91звёзд репо visant-premiere-editor Скилл visant-premiere-editor для Claude Code собирает черновой монтаж в Adobe Premiere Pro из JSON-плана нарезки. Переносит таймлайн через XML и MCP без потери кадров. CX Codex +1 ★ 91звёзд репо visant-refine Скилл visant-refine для Claude Code помогает оформлять графики, шкалы, спарклайны и панели управления в едином визуальном стиле. Подключается по просьбе добавить график, слайдер симулятора или доработать интерфейс. CX Codex +1 ★ 91звёзд репо visant-frontend Скилл visant-frontend для Claude Code разбирает интерфейсные решения через бизнес-переменные и требует таблицу классификации маршрутов. Запускается на просьбы переделать экран, раскритиковать интерфейс или разобрать визуальную иерархию. CX Codex +1 ★ 91звёзд репо visant-killer Скилл visant-killer для Claude Code проводит строгий аудит интерфейса перед пулл-реквестом. Отлавливает шаблоны ИИ-генерации, лишние анимации и ошибки группировки в разметке. CX Codex +1 ★ 91звёзд репо visant-motion Скилл visant-motion для Claude Code задаёт правила анимации интерфейсов и микропереходов. Включается по запросам об анимации, переходах, загрузке и скелетонах. CX Codex +1 ★ 91звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой