technical-writing · frappe — скилл для Claude Code: простой технический текст

Что делает technical-writing

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

Правила разложены по блокам. В словах — один предмет называется одним именем, короткое слово вместо длинного (start, а не commence; use, а не utilize). В глаголах — активный залог и запрет прятать действие в существительное: не «perform an analysis», а «analyze». В предложениях — лимит в 20 слов для инструкции и 25 для описания, без сокращений и без трёх существительных подряд. Отдельный блок про структуру: один абзац — одна тема, не больше шести предложений, шаги нумерованным списком.

Скилл не для всего подряд. Маркетинговые тексты, эссе и код он не трогает — там нужен голос, а не регламент. Ещё он требует американское написание, так что в проекте с британской орфографией ждите правок в другую сторону. Точку с запятой правила запрещают, а тире оставляют на ваше усмотрение.