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

humanize-docs — скилл для Claude Code: что делает и как установить

Скилл humanize-docs для Claude Code переписывает шаблонную документацию от нейросетей в связный текст. Устраняет избыточные чекбоксы и монотонную структуру разделов.

MIT ★ 26 обновлён 2026-11-16

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

Что делает humanize-docs

Перестраивает структуру технических описаний, инструкций и файлов README, чтобы избавить их от машинных паттернов. В отличие от правок отдельных слов, алгоритм убирает однообразную длину абзацев, сплошные списки задач и избыточные шаблоны кода.

Процесс опирается на инструменты Read, Write, Edit и Glob. Работа делится на пять трансформаций: изменение длины предложений, ломка симметрии разделов, перевод чекбоксов в связанный текст, контекстуализация сниппетов и чистка канцелярита вроде utilize или facilitate. Глубина переработки зависит от типа: юридические и медицинские документы меняются мягко, а онбординги и README переписываются агрессивно.

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

  • переписать монотонные списки чекбоксов в связные последовательные шаги
  • сломать механическую симметрию абзацев и выровнять ритм предложений
  • заменить роботизированные глаголы на простую живую лексику
  • адаптировать тон документации под контекст от спецификаций до онбординга

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

  • Перепиши файл README.md и сделай подачу менее формальной
  • Убери чекбоксы и машинный тон из онбординга для разработчиков
  • Переделай структуру технической спецификации, сохранив точность

Как установить humanize-docs

1Через Skills CLI (Vercel)

npx skills add wrg32786/aigent-os --skill humanize-docs -a claude-code

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

~/.claude/skills/humanize-docs/SKILL.md

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

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

Вопросы о humanize-docs

Как установить humanize-docs в Claude Code?

Выполните команду npx skills add wrg32786/aigent-os --skill humanize-docs -a claude-code. Файл конфигурации сохранится в ~/.claude/skills/humanize-docs/SKILL.md.

Чем humanize-docs отличается от других скиллов очеловечивания?

Обычные редакторы исправляют фразы на уровне предложений. Этот скилл перестраивает композицию документа целиком: убирает шаблонные чекбоксы, разбавляет одинаковые абзацы и связывает сниппеты кода с контекстом.

Что нужно для работы humanize-docs?

Внешние сервисы и ключи API не нужны. Скиллу требуются стандартные права агента на работу с файловой системой через Read, Write, Edit и Glob.

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

SKILL.md · MIT
---
name: humanize-docs
version: 1.0.0
description: "Rewrite AI documentation structure and flow into conversational prose. Use when humanizing docs, removing checklist spam, or making rigid documents readable."
license: MIT
compatibility: claude-code opencode
source: https://github.com/skillkit-marketplace/skills/tree/main/skills/humanize-docs
allowed-tools:
  - Read
  - Write
  - Edit
  - Glob
---

# Humanize Docs

Transforms robotic AI-generated documentation into prose that sounds like an actual human wrote it. The approach is **aggressive deformalization** — not just tweaking tone, but restructuring how information flows to break AI's predictable patterns.

This is a different tool than the humanizer skill. Humanizer removes AI writing tells at the sentence/phrase level (em-dashes, rule-of-three, vague attributions, sycophantic openers). Humanize-docs attacks structural AI-ness: checkbox spam, template overload, perfect symmetry, emotional flatness across an entire document.

## When to use this

Clear signals you're dealing with AI-generated docs:
- Checkbox overload: `- [x] Task 1: Do the thing (AC: #1)`
- CAPS LOCK for CRITICAL IMPORTANT NOTES
- 8+ code templates embedded in one document
- Every section has exactly 3 perfectly balanced paragraphs
- Headers like "LLM Developer Guardrails"
- Phrases: "Certainly, here is...", "It's important to note that...", "Furthermore..."

## Transformation workflow

### Step 1: Detect

Quick test — does the doc have 5+ of these?
- Perfect structural symmetry (every section same length)
- Zero sentence length variation (all 15-20 words)
- Checkbox addiction
- Template embedding mania
- Emotional flatness (no "wait, why?" or "honestly...")

If yes, proceed. If no, it might already be human-written — don't over-transform.

### Step 2: Apply the five core transformations

Execute in order. Don't apply all of them everywhere — humans are inconsistent. Some sections stay formal, others get playful. That asymmetry is the point.

**1. Burstiness injection**
Mix 5-word punches with 30-word reflections. AI writes at one rhythm. Humans don't.

Before:
> The system processes requests through a standardized pipeline that validates inputs and returns structured responses to the calling service.

After:
> It's a pipeline. Request comes in, gets validated, structured response goes back out. Nothing exotic — but the validation step is where things quietly break.

**2. Structure dismantling**
Break perfect 3-paragraph blocks. Add digressions. Not every section needs the same shape.

**3. Checkbox annihilation**
Convert checklists to flowing prose with "anyway, you'll need..." or "first thing is..."

Before:
> - [x] Install package A (required for Task 3)
> - [x] Verify installation with command X
> - [x] Proceed to next task only after confirmation

After:
> Install package A first — Task 3 depends on it. Run command X to verify it worked. Once you get confirmation, move on. If it errors out, the next step breaks, so don't skip this.

**4. Template contextualization**
Replace code dumps with "here's what worked for me..." framing. Give the template a reason to exist before showing it.

**5. Vocabulary swap**
Kill: utilize, leverage, facilitate, ensure, enable, enhance, robust, seamless
Use: use, use, help, make sure, let, improve, solid, smooth

### Step 3: Quality check

Read the output aloud. Does it sound like you'd actually say this to someone?

Red flags the transformation failed:
- Still too even (every paragraph same vibe)
- No variation in sentence rhythm
- Feels like a "professional robot" instead of a person
- You removed personality instead of adding it

Good signals:
- Some sentences feel almost too casual (then you toned it back)
- It reads faster than before
- You can hear a specific person's voice

### Step 4: Domain calibration

Intensity varies by doc type:

| Doc type | Intensity |
|---|---|
| READMEs, internal team docs, onboarding guides, tutorials | High |
| API docs, help docs, technical specs | Moderate |
| Legal, compliance, medical, financial | Gentle only |

## Quick mode (30 seconds)

Just need to make something readable without full transformation:

1. Kill the checkboxes — flowing list with "you'll need: X, Y, and Z"
2. Replace one CAPS LOCK section with italics + context
3. Add one burstiness break — a 5-word sentence after a long paragraph
4. Swap 3-5 AI vocabulary words (utilize→use, leverage→use, facilitate→help)

Not perfect, but 70% better readability.

## Common mistakes

Don't:
- Remove ALL structure (humans still use headers)
- Make everything casual (inconsistency is human)
- Add emojis
- Force humor
- Ignore domain context

Do:
- Vary transformation intensity across sections
- Keep some sections more formal for contrast
- Read aloud to check naturalness
- Preserve technical accuracy above all

## Philosophy

AI writes like it's afraid to break rules. Humans write like they're explaining something to a friend while occasionally remembering they should sound professional. Capture that tension.

## Related skills

- humanizer — sentence/phrase level AI pattern removal (Wikipedia taxonomy, 29 rules)

© wrg32786 · MIT · wrg32786/aigent-os

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

Все скиллы по теме «Тексты и документация» →
humanize Claude Code Academic Workflow Скилл humanize находит штампы и речевые маркеры нейросетей в текстах LaTeX, Quarto и Markdown. Создаёт отчёт с проблемными местами перед подачей статьи в журнал. CX Codex +1 ★ 1 729звёзд репо re0 LilMGenius Скилл re0 для Claude Code и Codex переписывает накопившие шум артефакты в чистовую версию v0. Включается при запросах убрать дубли, синхронизировать связанные файлы и сгладить текст. CX Codex +1 1 500установок avoid-ai-writing Conor Bronsdon Плагин avoid-ai-writing для Claude Code аудирует и переписывает прозу, которая читается как машинная. Работает с README, чейнджлогами, описаниями PR и документацией. CX Codex ★ 42 780звёзд репо slack-docs slackapi Скилл slack-docs ищет нужную страницу на docs.slack.dev и читает её как markdown, чтобы ответы про платформу Slack опирались на актуальную документацию, а не на память модели. CX Codex +1 4 300установок docs-write metabase Скилл docs-write помогает писать и редактировать Markdown и MDX в стиле Metabase. Он пригодится для рабочих инструкций, описаний функций и другой документации. CX Codex +1 2 100установок docs-review metabase Скилл docs-review проверяет изменения в markdown-документации на соответствие стайлгайду Metabase и выдаёт нумерованный список замечаний. CX Codex +1 2 000установок

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

Весь набор →
memory-bridge Скилл memory-bridge для Claude Code связывает запросы к памяти с Hindsight и Jev. Он запускается только по явной просьбе сохранить, найти или осмыслить заметку. CX Codex +1 ★ 26звёзд репо Learn Скилл Learn для Claude Code оформляет результаты изучения репозитория, доклада или инструмента. Он помогает зафиксировать решение и условия, при которых его стоит пересмотреть. CX Codex +1 ★ 26звёзд репо learn-from-failure Скилл learn-from-failure для Claude Code разбирает сбои и проверяет, повторялась ли их причина. После повторов он помогает создать артефакт, который должен предотвратить тот же сбой. CX Codex +1 ★ 26звёзд репо impeccable Скилл impeccable для Claude Code помогает создавать страницы и приложения, задавать стиль интерфейса и выделять компоненты с дизайн-токенами. Перед работой ему нужен контекст о пользователях, задачах и характере бренда. CX Codex +1 ★ 26звёзд репо Honesty Check Скилл Honesty Check для Claude Code собирает сведения о выполненной работе в журнал честности. Он включается перед сообщением о готовности задачи или передавая работу на ревью. CX Codex +1 ★ 26звёзд репо first-win Предлагает три стартовые задачи с готовым результатом. Вызовите /first-win, чтобы превратить пост в публикации, идею — в план или письма — в список приоритетов. CX Codex +1 ★ 26звёзд репо First 10 Moves Скилл First 10 Moves для Claude Code помогает освоиться в незнакомом репозитории и найти место, связанное с задачей. Включается при поиске бага, исследовании кода или подготовке правки. CX Codex +1 ★ 26звёзд репо find-weakness Скилл find-weakness для Claude Code и Codex находит главное возражение и самую рискованную скрытую предпосылку в архитектурном решении или отдельном утверждении. CX Codex +1 ★ 26звёзд репо

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

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