llm-writing · haowjy, claude — скилл для Claude Code: что делает и как установить
Скилл llm-writing для Claude Code задаёт правила редактирования текстов перед сохранением в репозиторий. Очищает коммиты, PR, документацию и промпты от шаблонных фраз языковых моделей.
Apache-2.0 815 установок ★ 601 обновлён 2026-11-16
npx skills add haowjy/creative-writing-skills --skill llm-writing -a claude-codeЧто делает llm-writing
Скилл убирает из проектных текстов канцелярит и шаблонные нейросетевые обороты. Инструкции требуют писать простыми словами, использовать точные имена файлов и функций из кодовой базы, а также удалять паразитные связки вроде вводных замечаний и повторных выводов в конце.
Правила запрещают переносить временный контекст диалога в долговечные файлы. Скилл исключает промежуточные идентификаторы, ссылки на рабочие папки чата и отсылки к старым репликам. Черновик правится целиком в целевом файле или на черновике до отправки в репозиторий. При усложнении текста скилл обращается к вспомогательным правилам intent-modeling и information-hierarchy.
Какие задачи решает
- очистить текст коммитов и PR от шаблонных нейросетевых фраз
- удалить контекстный мусор чата из документации и файлов AGENTS.md
- заменить выдуманный жаргон на точные термины кодовой базы
- убрать лишние резюме и пустые утверждения без доказательств
Примеры запросов агенту
- Напиши текст для pull request по правилам llm-writing
- Отредактируй раздел README.md без шаблонных фраз нейросетей
- Составь сообщение коммита по последним правкам в схеме базы данных
Как установить llm-writing
1Через Skills CLI (Vercel)
npx skills add haowjy/creative-writing-skills --skill llm-writing -a claude-code2Вручную: положить файлы
~/.claude/skills/llm-writing/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/llm-writing/
1Через Skills CLI (Vercel)
npx skills add haowjy/creative-writing-skills --skill llm-writing -a codex2Вручную: положить файлы
.agents/skills/llm-writing/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add haowjy/creative-writing-skills --skill llm-writing -a cursor2Вручную: положить файлы
.cursor/skills/llm-writing/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install haowjy/creative-writing-skills plugin/claude/skills/llm-writing2Вручную: положить файлы
.github/skills/llm-writing/SKILL.md1Через Skills CLI (Vercel)
npx skills add haowjy/creative-writing-skills --skill llm-writing -a gemini-cli2Командой платформы
gemini skills install https://github.com/haowjy/creative-writing-skills --path plugin/claude/skills/llm-writingВручную: положить файлы
.devin/skills/llm-writing/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add haowjy/creative-writing-skills --skill llm-writing -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о llm-writing
Как установить llm-writing в Claude Code?
Выполните команду npx skills add haowjy/creative-writing-skills --skill llm-writing -a claude-code. Конфигурация запишется в ~/.claude/skills/llm-writing/SKILL.md.
Что делает llm-writing?
Задаёт редакционные ограничения для файлов, коммитов, PR и документации. Скилл убирает вводные клише, водянистые связки и шум из текущего диалога с агентом.
Что нужно для работы llm-writing?
Внешние API-ключи и фоновые сервисы не требуются. Для больших текстов скилл может задействовать соседние правила intent-modeling и information-hierarchy из того же репозитория.
Исходный текст
SKILL.md · Apache-2.0
---
name: llm-writing
description: 'Load before you write a commit message, PR body, changelog entry, issue, report to the user, doc, README, AGENTS.md or .context/ page, KB page, or prompt: choose plain words, write for the reader''s context, and strip default LLM phrasing.'
metadata:
type: guardrail
---
# LLM Writing
Load `/creative-writing-skills:intent-modeling` if it isn't already loaded, and `/creative-writing-skills:information-hierarchy` when the piece grows beyond a short answer.
## Write for the Reader
Text that outlives the conversation (files, prompts, docs, commit messages, PRs) is read by someone without it: a cold agent, a teammate, or the person who asked, after they've forgotten it. Before writing, decide who reads it, what they know when they start, and what they came for, then lead with what serves them and cut what only serves you. Break the piece into beats, each one move in the reader's journey. Check the source material it rests on.
Draft the whole piece where you can revise it before it reaches its reader: the file itself, or a scratch file. Text sent straight into a chat, a PR or a commit gets no revision. Revise from the whole piece down to the words: is each part correct, does it follow from what came before, and does the reader need it? After a local change, reread the beat around it.
## Choose Words
- Use the short, everyday word: "use", not "utilize"; "help", not "facilitate". A long word has to buy its length with precision.
- The project's own names are the word list. Write the real name as the project spells it, whether a symbol, a file, a flag, a character, or an invented term, not a synonym or a description of it, and call each thing by one name everywhere.
- Don't invent jargon. Use the words the reader would say out loud ("move", "delete", "a budget that only decreases"), not a coined metaphor ("evacuate", "ratchet"). A named pattern is fine when the text says what it means the first time.
- Be specific over sterile: not "schema changes can cause issues" but "a column rename fails the build".
- Vary the rhythm. Short sentences land a point; longer ones carry a fact with its condition or consequence. Split the sentence that carries two thoughts; keep the long one that carries one.
- Leave no sentence open to two readings: "only" and "not" next to the word they change, every "it" and "this" pointing at one noun, no noun strings. The cases and a before/after are in `resources/word-choice.md`.
## What to Delete
- Writing to fill a section because it exists. Delete it or merge its content where it belongs.
- Labeling concepts without explaining how they work. Explain the mechanism or cut the label.
- Stating conclusions without evidence. Show the evidence or drop the claim.
- Hiding uncertainty behind confident language. Say what you don't know.
- Softening every claim with qualifiers ("it's worth noting," "it's important to consider"). Say it or don't.
- Repeating what you already said in different words, or summarizing the body as a conclusion ("In summary," "Overall").
- Connecting ideas with transition words instead of meaning ("Moreover," "Furthermore," "Additionally"). If the relationship isn't clear without the word, restructure.
- Pairing clauses where one half already carries the meaning ("It's not X, it's Y"). Keep the half that carries it.
- Conversational bleed: writing as if replying inside the conversation that produced the text. Terms coined there, labels and IDs minted during the work (a ruling number, a finding ID, a lane name), the incident behind a rule, links into a work directory or anything else that won't last, "the old version," "as discussed," answers to questions the reader never asked. The reader wasn't there. Write for the reader, with reasons they can check without the conversation.
To commission a cold read of durable pages, and act on its findings, open `resources/cold-read.md`.
© haowjy · Apache-2.0 · haowjy/creative-writing-skills
Похожие скиллы
Все скиллы по теме «Тексты и документация» →Сначала — llm-writing от других авторов.