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

human-copywrite — скилл для Claude Code: стиль Apple для текстов

Скилл human-copywrite применяет правила из Apple Style Guide к любому тексту, который будут читать люди: UI-строкам, документации, маркетингу, сообщениям об ошибках. Срабатывает автоматически при написании или редактировании копии.

MIT 207 установок ★ 227 обновлён 2026-08-15

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

Что делает human-copywrite

human-copywrite загружает редакционные правила Apple (июнь 2025) и применяет их к пользовательскому контенту. Внутри — рекомендации по голосу и тону (активный залог, второе лицо, простые слова), пунктуации, заглавным буквам, дефисированию сложных определений, написанию чисел и дат, терминам для UI-элементов (button, control, sheet, popover), корректным названиям Apple-продуктов и техническому форматированию в документации разработчика.

Скилл срабатывает при написании UI-строк, сообщений об ошибках, справки и туториалов, описаний API, маркетинговых текстов, заметок о релизе и локализованного контента. Не применяется к именам функций, переменных или чистому коду без пользовательского текста.

Включает справочник на A-Z для быстрого поиска (backup vs back up, login vs log in, 2D, 24/7), таблицу единиц измерения (GB, MHz, mm), список Apple-устройств и сервисов, а также правила для интернационального стиля (ISO даты, коды стран, форматы телефонов).

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

  • выбрать правильную форму слова: backup или back up, login или log in
  • написать UI-кнопку или сообщение об ошибке в стиле Apple
  • оформить число, дату, диапазон или единицу по гайду
  • отредактировать документацию, чтобы убрать жаргон и пассив
  • подготовить текст к локализации с учётом ISO-стандартов

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

  • Отредактируй текст кнопки: «Нажмите здесь для сохранения» — какой стиль будет правильнее?
  • Я пишу справку про синхронизацию между iPhone и Mac. Как назвать окно и кнопки?
  • Нужно описать в документации, что функция save() делает. Как написать комментарий в коде?

Как установить human-copywrite

1Через Skills CLI (Vercel)

npx skills add pproenca/dot-skills --skill human-copywrite -a claude-code

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

~/.claude/skills/human-copywrite/SKILL.md

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

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

Вопросы о human-copywrite

Как установить human-copywrite в Claude Code?

Запустите npx skills add pproenca/dot-skills --skill human-copywrite -a claude-code, затем откройте ~/.claude/skills/human-copywrite/SKILL.md для справки.

Что делает human-copywrite?

Применяет редакционные правила Apple Style Guide к любому тексту для читателя: от UI-кнопок до документации и маркетинга. Срабатывает автоматически при написании копии, даже если вы не упомянули гайд или стилистику.

Можно ли использовать human-copywrite для документации разработчика?

Да, включены правила технического форматирования для API-документации: как писать синтаксис, плейсхолдеры и код в комментариях. Общий подход — активный залог, второе лицо, конкретность вместо жаргона.

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

SKILL.md · MIT
---
name: human-copywrite
description: "User-facing copy — UI strings, documentation, marketing, release notes, error messages, onboarding flows, blog posts, or anything that a person will read. Distilled from the Apple Style Guide (June 2025): voice and tone (active voice, present tense, second person, no jargon), punctuation, capitalization, hyphenation rules for compound modifiers, when to spell out numbers, units of measure, UI vocabulary (button vs control vs sheet vs popover), Apple product and feature naming, technical notation for developer docs, and international style for localization. Trigger when writing, editing, or reviewing copy — even if the user doesn't explicitly mention \"style guide\" or \"copywriting,\" any time the deliverable is human-readable text the rules here apply. Especially valuable when the user is writing instructions, naming UI elements, or deciding how to format a number, date, or unit."
---
# Human Copywrite

Editorial style and usage guidance distilled from the Apple Style Guide (June 2025). Use it whenever you're producing text a human will read.

## When to Apply

Trigger this skill whenever the output is text a human will read. Specifically:

- **UI strings & error messages** — button labels, dialog text, empty states, onboarding copy. Voice and UI-vocabulary rules apply.
- **User-facing documentation** — help articles, READMEs, onboarding guides, tutorials. All rules apply.
- **Developer documentation** — API references, SDK guides, code comments meant for humans. Add the technical-notation rules.
- **Marketing copy** — feature announcements, landing pages, release notes. Voice, capitalization, and product-name rules are load-bearing.
- **Localized content** — anything that will be translated. The international-style rules become primary.
- **Writing about Apple platforms** — even if the surrounding product isn't an Apple product, refer to Apple hardware/software by Apple's preferred forms (iPhone, iPad, macOS, App Store).

If the user is writing code with no user-facing strings, skip this skill. If they're writing a function name or variable, that's not copywriting — that's naming, which lives elsewhere.

## Core Principles

These run through every section. When in doubt, fall back on them.

1. **Active voice, present tense, second person.** *You can connect your iPhone to a Mac.* Not *Your iPhone may be connected to a Mac.*
2. **Specific over generic.** *Choose File > Save.* Not *Use the menu to save the file.*
3. **Plain words over jargon.** *Turn on* over *activate*. *Log in* over *authenticate* (unless authenticate is technically precise).
4. **Don't make the product the subject of an action the user takes.** *You can create a database with FileMaker Pro.* Not *FileMaker Pro allows you to create a database.*
5. **Items *appear* on screen — they don't *display*.** *The setup assistant appears.* Not *The setup assistant is displayed.*
6. **Don't restate what code does — say *why*.** Applies to code comments.
7. **Respect product names verbatim.** AirPods (not Airpods), iCloud (not iCloud+ unless you mean the paid tier), Apple Pencil (not the Apple pencil).
8. **Numbers ≥10 stay digits; <10 spell out** — but with many exceptions ([numbers-and-dates.md](references/numbers-and-dates.md)).
9. **Compound modifiers preceding a noun are hyphenated; following the verb they're not** — *user-friendly app*, *the app is user friendly*.
10. **In code, never use a function name as a verb.** *Run `ls` on both directories* — not *`ls` both directories*.

## How to Use

Always read this SKILL.md first, then load the topic file(s) relevant to the current task. For one-off term lookups, jump to [references/a-z-lookup.md](references/a-z-lookup.md) and follow its pointer to the topic file.

### Topic files

| File | When to read |
|------|--------------|
| [voice-and-tone.md](references/voice-and-tone.md) | Any user-facing prose. Most copy decisions live here. |
| [punctuation.md](references/punctuation.md) | Deciding on em dashes, en dashes, ellipses, commas, colons, apostrophes, quotes. |
| [capitalization.md](references/capitalization.md) | Writing headings, titles, button labels, or proper-noun-adjacent terms. |
| [hyphenation-and-compounds.md](references/hyphenation-and-compounds.md) | Compound modifiers, e- and re- prefixes, *user-friendly* vs *user friendly*. |
| [numbers-and-dates.md](references/numbers-and-dates.md) | Writing dates, times, ranges, ordinals, percentages, fractions, decades, *2D*, *4K*, *24/7*. |
| [units-of-measure.md](references/units-of-measure.md) | Quoting GB, MHz, mm, inches, etc. Full SI unit/symbol table. |
| [word-choice-and-confusables.md](references/word-choice-and-confusables.md) | Pairs like *affect/effect*, *backup/back up*, *login/log in*, *OK*, *email*, *online*. |
| [abbreviations-and-acronyms.md](references/abbreviations-and-acronyms.md) | When to spell out, file types, plurals, articles. Includes industry acronyms (URL, ISP, JPEG, etc.). |
| [ui-elements.md](references/ui-elements.md) | Vocabulary for buttons, menus, sheets, popovers, sidebars, controls. |
| [apple-products.md](references/apple-products.md) | Apple hardware names: iPhone, iPad, Mac, MacBook, Apple Watch, AirPods, Apple Pencil, etc. |
| [apple-features-software.md](references/apple-features-software.md) | macOS, iOS, iCloud, Apple Music, Siri, AirDrop, Apple Intelligence, Genmoji, and all Apple software/services/features. |
| [technical-notation.md](references/technical-notation.md) | Developer documentation: code font, syntax descriptions, placeholders. |
| [international-style.md](references/international-style.md) | Localized or international content: ISO country/currency/language codes, ISO 8601 dates, telephone numbers. |

### A-Z lookup

For a single term ("How do I write *backup* vs *back up*?"), open [references/a-z-lookup.md](references/a-z-lookup.md) and follow the pointer to the topic file with that entry.

## Gotchas

See [gotchas.md](gotchas.md). One scope note worth knowing up front: the source's "Writing inclusively" chapter (pronouns, person-first vs identity-first language, replacements for *blacklist/whitelist* and *master/slave*) was intentionally excluded from this skill at ingest time.

## Source

Apple Style Guide, June 2025 (243 pages). Distilled and re-organized by topic for selective loading. Source content is preserved verbatim where reproduced. The web version of the guide is at https://support.apple.com/guide/applestyleguide/welcome/web.

© pproenca · MIT · pproenca/dot-skills

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

Все скиллы по теме «Тексты и документация» →
woocommerce-copy-guidelines secondsky Скилл woocommerce-copy-guidelines для Claude Code и других платформ задаёт правила написания текстов интерфейса WooCommerce: кнопки, поля, сообщения, документация. Держит единый стиль, когда над магазином работает несколько человек. CX Codex +1 381установок human-writing pr-pm Скилл human-writing для Claude Code и других агентов помогает писать технические тексты живым языком инженера, без корпоративных штампов и общих фраз. CX Codex +1 3установок writing-copy spencerpauly Скилл writing-copy для Claude Code задаёт агенту правила маркетингового текста: заголовки, CTA, письма, микрокопирайт. Покрывает интерфейс и лендинг внутри того же проекта. CX Codex +1 475установок copywriting-prose-creator samber Скилл copywriting-prose-creator для Claude Code кодифицирует стиль письма бренда или автора в PROSE.md: лексику, синтаксис, ритм, структуру и фирменные приёмы отдельно от эмоционального тона. CX Codex +1 5 400установок brand-review официальный anthropics Скилл brand-review проверяет маркетинг-текст, копирайт и контент против гайда вашего бренда, стиля и принципов. Находит отклонения по уровню серьёзности и предлагает исправления. CX Codex +1 3 400установок brand-voice-analyzer OneWave-AI Скилл brand-voice-analyzer разбирает тексты компании, формирует гайдлайн по тону бренда и проверяет новые статьи на соответствие ему. CX Codex +1 281установок

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

Весь набор →
cli-review-runner Скилл cli-review-runner для Claude Code проверяет CLI-команду по 45 правилам каталога cli-for-agents и оценивает, может ли агент безопасно использовать её в пайплайне. CX Codex +1 219установок openai-codex-rust-patterns Скилл openai-codex-rust-patterns добавляет 63 инженерных правила для разработки на Rust из кодовой базы агента OpenAI Codex. Помогает писать надёжный async-код, изолировать подпроцессы и проектировать enum-ошибки. CX Codex +1 219установок marketplace-search-recsys-planning Скилл marketplace-search-recsys-planning для Claude Code помогает планировать поиск и рекомендации в маркетплейсе на OpenSearch: от структуры индекса до оценки качества. Охватывает планирование новой и разбор существующей системы. CX Codex +1 211установок marketplace-personalisation Скилл marketplace-personalisation для проектирования и отладки систем рекомендаций в двусторонних маркетплейсах на AWS Personalize. CX Codex +1 208установок marketplace-recsys-feature-engineering Скилл marketplace-recsys-feature-engineering проектирует признаки для рекомендательных систем маркетплейсов по фотографиям, анкетам и метаданным. Помогает настроить i2i, u2i и u2u рекомендации без лишних моделей. CX Codex +1 206установок computer-science-algorithms Скилл computer-science-algorithms помогает подобрать структуру данных и найти скрытые замедления O(n²) в циклах. Пригодится при проектировании графов или обработке потоковых данных. CX Codex +1 205установок marketplace-pre-member-personalisation Скилл marketplace-pre-member-personalisation для Claude Code, Cursor, Codex и других агентов покрывает путь анонимного посетителя до платного участника двустороннего маркетплейса. CX Codex +1 204установок design-review Скилл design-review для Claude Code проверяет существующий UI в коде и браузере и выдаёт приоритетные правки. Проверяет React-интерфейсы перед слиянием изменений. CX Codex +1 180установок

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

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