The Elements of Style — плагин
Правила письма Струнка 1918 года для агента: скилл применяет их к документации, коммитам и сообщениям об ошибках
- 627 ★ репозитория
- Последний коммит
Минимальный доступ
Почему такой уровень
- Плагин состоит из скилла и справочника, ничего не запускает и никуда не ходит
- Справочник занимает около 12 000 токенов контекста
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add plugins/the-elements-of-styleОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемМинимальный доступИнструмент ничего не запускает и не ходит в сеть.
- Плагин состоит из скилла и справочника, ничего не запускает и никуда не ходит
- Справочник занимает около 12 000 токенов контекста
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Плагин упаковывает «The Elements of Style» Уильяма Струнка-младшего (1918) для агентов-программистов. Когда агент пишет текст для людей, он вызывает скилл `writing-clearly-and-concisely`: документацию, сообщения коммитов, тексты ошибок, пояснения, отчеты и надписи интерфейса. Скилл перечисляет все правила списком и предупреждает, что полный справочник занимает около 12 000 токенов, поэтому `elements-of-style.md` открывается только при написании или правке. Когда контекста не хватает, скилл советует отдать черновик субагенту. Справочник состоит из трех частей: семь правил употребления (грамматика и пунктуация), одиннадцать принципов композиции и алфавитный список слов и выражений, которые часто употребляют неверно.
Для кого. Разработчикам, которые пишут документацию, сообщения коммитов и тексты ошибок на английском и хотят короче и яснее.
Подходит, если
- Сообщения коммитов агента длинные и расплывчатые, их нужно подтянуть до плотного стиля
- README или руководство пользователя на английском переписывают без воды
- Тексты ошибок и подсказок интерфейса стоит сделать понятнее с первого прочтения
- Черновик отчета проходит финальную правку по каноническим правилам композиции
Не подходит, если
- Текст на русском или другом языке: правила написаны для английского 1918 года
- Нужно убрать признаки ИИ-генерации: для этого в каталоге есть отдельные скиллы
- Контекст агента почти исчерпан: справочник занимает около 12 000 токенов
Пример запроса к агенту
Перепиши описание PR по правилам Струнка: убери лишние слова и поставь действие в начало фразыОграничения
Правила Струнка относятся к английскому языку начала XX века, для русских текстов они не подходят. Полный справочник стоит около 12 000 токенов контекста. Установка для каждого агента описана в отдельных файлах docs/install, а README только отсылает к ним. Файлы манифестов сгенерированы инструментом `everyharness`, править их вручную нельзя. Скилл рассчитан на случаи, когда агент пишет текст для людей, и на код и конфигурацию не влияет.
Как отключить. В Claude Code выполните `/plugin uninstall elements-of-style@elements-of-style-dev`, и скилл перестанет подгружаться.
Частые вопросы
Как поставить The Elements of Style в Claude Code?
Выполните `/plugin marketplace add obra/elements-of-style`, затем `/plugin install elements-of-style@elements-of-style-dev`. Для остальных агентов README отсылает к файлам docs/install: Cursor, Codex, Gemini CLI, OpenCode и другие.
Откуда взят текст справочника?
Это издание 1918 года из Project Gutenberg (номер 37134), переведенное в Markdown. Текст находится в общественном достоянии.
Почему скилл не читает справочник целиком каждый раз?
Справочник занимает около 12 000 токенов, и скилл подгружает его только при написании или правке текста. Правила сжато перечислены в самом SKILL.md.
Для каких агентов есть инструкции установки?
Для Claude Code, Cursor, Codex, Devin CLI, Kimi Code, Gemini CLI, OpenCode, Pi, Hermes Agent, клиентов Agent Plugins 1.0 и маркетплейсов Factory Droid, Grok и Copilot.
Когда агент вызывает этот скилл?
Когда пишет документацию, сообщения коммитов, тексты ошибок или другую прозу для людей. В задачах с кодом и конфигурацией скилл не нужен.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
ПлагиныСкилл учит агента писать документацию и ответы простым английским по правилам ASD-STE100: короткие фразы, один термин, условие перед командой
Скилл правки текста: убирает шаблонные обороты ИИ и сохраняет словарь, ритм и резкость автора, а не выравнивает стиль.
Скилл-плагин для Claude Code, который правит и вычитывает английский текст по стилю The Economist: ясность, точность, краткость
Скилл переписывает плотный и двусмысленный английский по правилам упрощенного технического языка ASD-STE100, чтобы текст не мог прочитать неправильно другой аге
Скилл убирает из текста защитные оговорки, извинения и лишние хеджи и делает формулировки прямыми, сохраняя нужные ограничения
Скилл правит и проверяет техническую документацию по принципам Google Developer Documentation Style Guide, не трогая факты.
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Звезды репозитория | Главное отличие |
|---|---|---|---|
| The Elements of Style (эта карточка) | нет | 627 | |
| Stop Slop | нет | 18 896 | вычищает шаблонные фразы ИИ по списку, здесь классические правила ясного письма |
| Economist Style Guide Plugin | нет | 129 | правит английский текст по стилю The Economist, здесь правила Струнка 1918 года |
Коротко о README
README объясняет, что плагин вручает агенту правила Струнка при написании любой прозы для людей, показывает таблицу установки для одиннадцати сред и поясняет, что манифесты генерирует `everyharness` из файла `everyharness`.yaml. В конце указан источник текста и его статус общественного достояния.
Бейдж для README
Исходный SKILL.md
--- name: writing-clearly-and-concisely description: Apply Strunk's timeless writing rules to ANY prose humans will read—documentation, commit messages, error messages, explanations, reports, or UI text. Makes your writing clearer, stronger, and more professional. --- # Writing Clearly and Concisely ## Overview William Strunk Jr.'s *The Elements of Style* (1918) teaches you to write clearly and cut ruthlessly. **WARNING:** `elements-of-style.md` consumes ~12,000 tokens. Read it only when writing or editing prose. ## When to Use This Skill Use this skill whenever you write prose for humans: - Documentation, README files, technical explanations - Commit messages, pull request descriptions - Error messages, UI copy, help text, comments - Reports, summaries, or any explanation - Editing to improve clarity **If you're writing sentences for a human to read, use this skill.** ## Limited Context Strategy When context is tight: 1. Write your draft using judgment 2. Dispatch a subagent with your draft and `elements-of-style.md` 3. Have the subagent copyedit and return the revision ## All Rules ### Elementary Rules of Usage (Grammar/Punctuation) 1. Form possessive singular by adding 's 2. Use comma after each term in series except last 3. Enclose parenthetic expressions between commas 4. Comma before conjunction introducing co-ordinate clause 5. Don't join independent clauses by comma 6. Don't break sentences in two 7. Participial phrase at beginning refers to grammatical subject ### Elementary Principles of Composition 8. One paragraph per topic