agentleFS
Abdullokh-NAbdullokh-N/proza-ru/skills/llm-writing/SKILL.md

llm-writing

Skill0 starsChanged 2 months agoApache-2.0View on GitHub

Как писать так, чтобы текст не читался как машинный. Применять при любом письме — прозе, эссе, письмах, документации. Даёт правила намеренного письма и список признаков машинного стиля, которые нужно удалять.

Files
SKILL.md

Письмо без машинного следа

Писать намеренно

Охват. До первой строки — одно предложение: что читатель знает на входе и что должен знать на выходе. Разница между ними и есть текст. Всё, что эту разницу не сокращает, вырезается.

Опора на источники. Каждое фактическое утверждение либо привязано к источнику, либо помечено как догадка. Проверить нечем — так и пиши: «не проверено».

Черновик на диск. Пиши в файл, а не в ответ. Текст, который нельзя перечитать целиком, нельзя и выправить.

Правка от целого к слову. Порядок: замысел → состав → абзац → фраза → слово. Если правка внизу обнажила дыру наверху — возвращайся наверх, а не латай снизу. Перестановка запятой не спасёт абзац, которого не должно быть.

Что удалять

Общее:

  • Раздел, написанный потому, что в плане был раздел.
  • Ярлык вместо механизма: «системный подход», «глубокая проработка», «сложные отношения». Назови, что именно происходит.
  • Вывод без доказательства.
  • Неуверенность, поданная уверенным тоном. Если не знаешь — скажи, что не знаешь.
  • Смягчители: «стоит отметить», «важно понимать», «нельзя не сказать», «следует учитывать».
  • Повтор уже сказанного другими словами.
  • «В итоге», «Подводя итог», «Таким образом» в конце абзаца или текста.
  • Связки вместо смысла: «Более того», «Кроме того», «Важно отметить». Связка законна, только если между частями есть настоящее отношение, а не порядок следования.

Русское:

  • Конструкция «не X, а Y» / «не X — Y», когда одна половина уже несёт смысл. «Это был не дом, а крепость» — вычеркни первую половину, если «крепость» понятна и так. Считай их: до трёх на текст — приём; от четырёх при плотности выше 4 на 1000 слов — правка [не проверено].
  • Отыменные предлоги: «в связи с», «в целях», «по причине», «в случае», «в рамках». Меняются на «из-за», «чтобы», «если», «при».
  • Расщеплённое сказуемое: «произвести осмотр» → «осмотреть», «оказать поддержку» → «поддержать», «принять решение» → «решить».
  • Отглагольные существительные вместо глаголов: «осуществление проверки заняло час» → «проверяли час». Сюда же цепочка родительных падежей: «вопрос улучшения качества обслуживания» — три родительных подряд, правка обязательна.

Оговорка: канцелярская форма законна, если это голос персонажа или сознательно взятый регистр — протокол, донос, отчёт. Список даёт диагноз, а не приговор.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.