# Навык агента по написанию блогов с ИИ для Клод Код

> Генерируйте, оптимизируйте и аудируйте контент блога в больших масштабах с помощью этого навыка агента по написанию блогов с ИИ для Клод Код. Он создаёт статьи с двойной оптимизацией для рейтингов Гугла и платформ цитирования ИИ, каждый раз обеспечивая высококачественный, SEO-дружественный контент.

- Canonical: https://nanoskill.ai/ru/skills/ai-blog-writing-skill
- Markdown: https://nanoskill.ai/ru/skills/ai-blog-writing-skill.md
- Author: AgriciDaniel
- Published: 2026-05-24T06:35:19.314Z
- Updated: 2026-07-25T04:39:13.470Z
- Language: ru
- Source type: github
- Popularity signal: 818

## Sources

- https://github.com/AgriciDaniel/claude-blog

## Install

```shell
npx skills add https://github.com/AgriciDaniel/claude-blog
```

## About

Навык написания блогов с ИИ и оптимизации SEO для Клод Код, известный как claude-blog, — это комплексный набор инструментов, разработанный для автоматизации и улучшения вашего процесса создания контента. Этот мощный навык пишет, оптимизирует и аудирует контент блогов в больших масштабах, гарантируя, что каждая статья тщательно создана как для рейтингов поисковой выдачи Гугла, так и для платформ цитирования ИИ. Это незаменимый инструмент для всех, кто стремится производить высококачественный, дружественный к SEO контент постоянно и эффективно.

Отличаясь надёжным 5-этапным контрактом доставки, claude-blog гарантирует качество контента, оценивая каждый черновик по 100-балльной шкале и блокируя всё, что ниже 90. Он предлагает двойную оптимизацию, ориентируясь на соответствие Основному обновлению декабря 2025 года и сигналам E-E-A-T для Гугла, а также подготавливая контент для платформ цитирования ИИ, таких как ЧатГПТ и Перплексити. С 30 дополнительными навыками, 5 агентами и 12 шаблонами контента он охватывает весь жизненный цикл контента от исследования и составления плана до генерации схемы и проверки цитирования.

Будь вы индивидуальный блогер, стремящийся к еженедельной качественной публикации, маркетинговая команда, управляющая разнообразными контент-портфелями, или разработчик навыков для Клод Код, ищущий эталонный образец промышленного уровня, claude-blog предлагает индивидуальные решения. Он поддерживает планирование кластеров тем, многоязычную публикацию, голосовые профили на основе персон, а также включает расширенные функции, такие как обнаружение каннибализации ключевых слов и конвейер проверки фактов для обеспечения точности и предотвращения конфликтов контента.

## Key features

- **5-этапный контракт поставки**: Каждый черновик проходит строгий 5-этапный контракт поставки (Возможности, Формат, Визуальное оформление, Проверка контента, Целостность ресурсов) по 100-балльной шкале, блокируя всё, что ниже 90, до того как это попадет к вам.
- **Двойная оптимизация для SEO и цитирования ИИ**: Каждая статья оптимизирована для рейтинга в Google (основное обновление декабря 2025 года, E-E-A-T) и платформ цитирования ИИ (ChatGPT, Perplexity, AI Overviews), что максимизирует видимость и цитируемость.
- **Комплексная генерация контента**: Движок блога полного цикла с 30 поднавыками, 5 агентами и 12 шаблонами контента, охватывающий исследование, план, черновик, схему, внутреннюю перелинковку и проверку цитирования за один запуск.
- **Персонализированное письмо и проверка фактов**: Управляйте настраиваемыми писательскими персонами с фреймворками тона и диапазонами читаемости, а также конвейером проверки фактов, который сверяет статистику с указанными источниками для обеспечения точности.
- **Обнаружение каннибализации ключевых слов**: Выявляйте и устраняйте пересечение ключевых слов между постами блога с оценкой серьезности и рекомендациями, чтобы предотвратить конкуренцию контента с самим собой в результатах поиска.

## Use cases

- **Генерируйте высококачественные посты в блог**: Индивидуальные блоггеры и создатели могут публиковать один качественный пост в неделю без ручных SEO-чеклистов, выполняя исследование, план, черновик, схему, внутреннюю перелинковку и проверку цитирования.
- **Управление контентом в масштабе для команд**: Маркетинговые команды и агентства могут управлять множеством постов по разным темам и на разных языках с помощью таких функций, как планирование тематических кластеров, многоязычная публикация и персонализированные голосовые профили.
- **Аудит и оптимизация существующего контента**: Используйте навык для анализа существующих постов блога с оценкой качества от 0 до 100, проведения SEO-валидации после написания и обнаружения каннибализации ключевых слов на вашем сайте.

## Result preview

Посмотрите реальный список лучших ИИ-инструментов для презентаций, созданный этим навыком агента.

![blog-writing-demo-01](https://file.nanoskill.ai/blog-writing-demo-01)

![blog-writing-demo-02](https://file.nanoskill.ai/blog-writing-demo-02)

![blog-writing-demo-03](https://file.nanoskill.ai/blog-writing-demo-03)

![blog-writing-demo-4](https://file.nanoskill.ai/blog-writing-demo-4)

## Result walkthrough

### Шаг 1：Установка

Добавьте навык вашему агенту.

![blog-writing-step-1](https://file.nanoskill.ai/blog-writing-step-1)

### Шаг 2：Генерация контента

Используйте специальную команду для генерации контента блога.

![blog-writing-step-2](https://file.nanoskill.ai/blog-writing-step-2)

### Шаг 3：Обзор и редактирование

Просмотрите контент и отредактируйте в сгенерированном документе Ворд.

![blog-writing-step-03](https://file.nanoskill.ai/blog-writing-step-03)

## Skill definition

# Навык написания и SEO-оптимизации блогов с ИИ для Claude Code (`claude-blog`)

> **Две версии этого навыка.** Выберите ту, которая лучше подходит вашему стилю работы:
>
> - 🌐 **Публичная с открытым исходным кодом**: [`AgriciDaniel/claude-blog`](https://github.com/AgriciDaniel/claude-blog). Лицензия MIT, публичные релизы, доступна всем. Используйте эту версию, если вам нужна стабильная, загружаемая и не требующая регистрации версия.
> - 🔒 **Приватное зеркало сообщества** (этот репозиторий): [`AI-Marketing-Hub/claude-blog`](https://github.com/AI-Marketing-Hub/claude-blog). Ранний доступ к разрабатываемым функциям (v1.9.0+ Контракт доставки блога, лестница героических изображений, мутационно-тестируемое регрессионное покрытие) и прямое сотрудничество с сообществом [AI Marketing Hub Pro](https://www.skool.com/ai-marketing-hub-pro). Требуется членство.
>
> Значки выше отслеживают **публичный** репозиторий (`AgriciDaniel/claude-blog`), так как приватное зеркало не видно для shields.io. Рабочий процесс публикации (приватная разработка, рецензирование, публичный релиз) документирован в [`docs/PUBLISHING.md`](docs/PUBLISHING.md).

> **Блог:** [Посмотрите, как работает claude-blog](https://agricidaniel.com/blog/claude-code-blog-writer)

**claude-blog — это набор навыков Claude Code, который пишет, оптимизирует и аудирует контент для блогов в больших объемах.** Каждая статья двойственно оптимизирована для ранжирования в Google (Обновление ядра декабрь 2025, E-E-A-T) и платформ цитирования ИИ (ChatGPT, Perplexity, AI Overviews). Контракт доставки v1.9.0 с 5 воротами оценивает каждый черновик по 100-балльной шкале и блокирует доставку всего, что набирает менее 90 баллов.

## Ключевые выводы

- **Что это такое**: полноценный движок для работы с блогами: 30 поднавыков, 5 агентов, 12 шаблонов контента, 21 справочник по требованию, 9 Python-скриптов корневого уровня, 160 пройденных тестов.
- **Для кого он предназначен**: для индивидуальных блогеров, маркетинговых команд, агентств и создателей навыков Claude Code, которым нужен контент производственного уровня, а не одноразовые черновики.
- **Основное обещание**: каждый черновик проходит контракт доставки с 5 воротами (Возможности, Формат, Визуализация, Обзор контента, Целостность ресурсов), или автор выполняет до 3 итераций, прежде чем уведомить вас.
- **Что делает его уникальным**: он использует собственный продукт. Согласованность версий обеспечивается CI на 14 поверхностях, гигиена текста запускается при каждом PR, три мутационно-тестируемых регрессионных набора фиксируют исправления v1.9.0, а `blog-reviewer` является БЛОКИРУЮЩИМ шлюзом, а не рекомендательным.
- **Сегодня**: v1.9.0, выпущена 18.05.2026. Работает с Next.js MDX, Astro, Hugo, Jekyll, WordPress, Ghost, 11ty, Gatsby и статическим HTML.

## Для кого claude-blog?

claude-blog обслуживает три аудитории с помощью одного движка:

**Индивидуальные блогеры и создатели**, которые хотят публиковать один качественный пост в неделю, не тратя три часа на SEO-чеклист. Оркестратор выполняет исследование, составление плана, написание черновика, разметку схемы, внутреннюю перелинковку и проверку цитирования за один вызов `/blog write`.

**Маркетинговые команды и агентства**, управляющие множеством постов по разным темам, языкам и платформам. Навык предоставляет планирование тематических кластеров (`/blog cluster`), многоязычную публикацию одной командой (`/blog multilingual`), обнаружение каннибализации (`/blog cannibalization`) и профили голосов на основе персонажей (`/blog persona`), чтобы один и тот же движок создавал консистентный контент для всей команды.

**Создатели навыков Claude Code**, которым нужен эталон производственного уровня для архитектуры навыков, диспетчеризации агентов, контрактов доставки и CI-ворот. Репозиторий демонстрирует открытый стандарт Agent Skills на уровне сложности Tier 4 со 160 тестами, принудительным соблюдением согласованности версий, регрессионными тестами синхронизации установщика и паттерном контракта с 5 воротами v1.9.0. Изучайте исходный код для вдохновения; форкайте паттерны в свои навыки.

## Что создает claude-blog?

Каждый черновик поставляется в виде 8 артефактов в одной папке. Сокращенный пример вывода `.md`:

```markdown
---
title: "Где должен устанавливаться плагин навыка Claude Code?"
description: "Рабочий ответ на вопрос о пути установки..."
date: "2026-05-18"
author: "Даниэль Агричи"
tags: [claude-code, навыки, плагины, установка]
canonical: "https://example.com/blog/skill-plugin-install-path"
---

# Где должен устанавливаться плагин навыка Claude Code?

Короткий ответ: большинство устанавливаемых пользователем плагинов навыков Claude Code
должны размещаться в `~/.claude/skills/<name>/` для контента навыка,
`~/.claude/agents/<name>.md` для агентов и
`~/.claude/scripts/<helper>.py` для любых Python-помощников.

## Ключевые выводы
- `~/.claude/skills/` — это поверхность SKILL.md.
- `~/.claude/agents/` содержит файлы агентов в формате Markdown.
- ... (полная статья, источники цитат, FAQ, JSON-LD схемы)
```

Наряду с `.md` контракт также создает: отрендеренный `.html` (XSS-безопасный JSON-LD, CSS с распознаванием темной темы), `.pdf` (Playwright или weasyprint), `hero.<ext>` (1200x630, созданное через Banana MCP, Gemini, стоковые API или Openverse), 3 скриншота для разных размеров экрана (`mobile-375.png`, `tablet-768.png`, `desktop-1280.png`), `review.md` (оценочная карта по 5 категориям с БЛОКИРУЮЩЕЙ строкой) и `preflight-report.json` (полный аудиторский след).

## Содержание

- [Демонстрация](#demo)
- [Быстрый старт](#быстрый-старт)
- [Команды](#команды)
- [Как claude-blog сравнивается?](#как-claude-blog-сравнивается)
- [Возможности](#возможности)
- [Контракт доставки (v1.9.0)](#контракт-доставки-v190)
- [Архитектура](#архитектура)
- [Требования](#требования)
- [Часто задаваемые вопросы](#часто-задаваемые-вопросы)
- [Дорожная карта](#дорожная-карта)
- [Удаление](#удаление)
- [Интеграция](#интеграция)
- [Документация](#документация)
- [Как цитировать](#как-цитировать)
- [Безопасность и Кодекс поведения](#безопасность--кодекс-поведения)
- [Вклад](#вклад)
- [Лицензия](#лицензия)
- [Связанные проекты](#связанные-проекты)
- [Автор](#автор)

## Демонстрация

[Смотреть демонстрацию на YouTube](https://www.youtube.com/watch?v=AeLC4iutG8w)

<p align="center">
  <img src="https://file.nanoskill.ai/blog-command-demo-9.gif" alt="Демонстрация команды claude-blog: маршрутизация подкоманд /blog через оркестратор" width="100%">
</p>

---

## Быстрый старт

> ℹ️ **Какую версию вы устанавливаете?**
>
> - **Не являетесь участником AI Marketing Hub Pro?** Установите из публичного репозитория: [`AgriciDaniel/claude-blog`](https://github.com/AgriciDaniel/claude-blog). Все приведенные ниже команды установки работают там. Просто замените `AI-Marketing-Hub/claude-blog` на `AgriciDaniel/claude-blog` и слаг плагина `claude-blog@ai-marketing-hub-claude-blog` на `claude-blog@agricidaniel-claude-blog`. Публичные релизы выходят там; это приватное зеркало опережает их.
> - **Участник Pro?** Приведенные ниже команды устанавливают **версию сообщества** с ранним доступом к разрабатываемым функциям. Они требуют аутентифицированной сессии `gh auth login` (или GitHub PAT) с доступом к организации `AI-Marketing-Hub`. Если `/plugin marketplace add` завершается ошибкой 404, ваш аккаунт еще не добавлен в организацию. Напишите в личные сообщения в [сообществе Skool](https://www.skool.com/ai-marketing-hub-pro), чтобы вас добавили.

**Установка плагина (Claude Code 1.0.33+):**

```bash
# Добавить маркетплейс (одноразово)
/plugin marketplace add AI-Marketing-Hub/claude-blog

# Установить плагин
/plugin install claude-blog@ai-marketing-hub-claude-blog
```

**Рекомендуется: клонировать, проверить, затем установить** (позволяет проверить `install.sh` и закрепить тег релиза):

```bash
git clone https://github.com/AI-Marketing-Hub/claude-blog.git
cd claude-blog
git checkout v1.9.0          # закрепить тег релиза (последний на 2026-05-18)
chmod +x install.sh && ./install.sh
```

**Установка одной командой (Unix/macOS):**

```bash
curl -fsSL https://raw.githubusercontent.com/AI-Marketing-Hub/claude-blog/main/install.sh | bash
```

**Установка одной командой (Windows PowerShell):**

```powershell
irm https://raw.githubusercontent.com/AI-Marketing-Hub/claude-blog/main/install.ps1 | iex
```

> Передача вывода `curl` или `irm` в оболочку дает скрипту права на исполнение на вашем компьютере. Более безопасен способ с клонированием и переходом на тег, так как вы можете проверить, что будет выполняться. Оба способа аутентифицируются в приватном репозитории с использованием существующих учетных данных `gh auth` / GitHub.

**Проверка целостности установщика (рекомендуется, усиление VULN-IAC-001):**

```bash
# Скачать, проверить SHA-256, затем запустить, если хеш совпадает.
curl -fsSL -o install.sh https://raw.githubusercontent.com/AI-Marketing-Hub/claude-blog/main/install.sh
echo "029388e448dd29bed259b130c2be42e2f6a16d4d5b6801a61bfb4f49b621fc04  install.sh" | sha256sum -c
bash install.sh
```

Приведенный выше SHA-256 актуален для текущего `install.sh` на HEAD ветки `main`. Сверяйтесь с [каноническим файлом](https://github.com/AI-Marketing-Hub/claude-blog/blob/main/install.sh) перед запуском. Хеш для `install.ps1`: `6d03f353e5d844c4fe5c7c0b2500bd1e2aad02468cd544013bab876735cebf98`. Хеши обновляются в этом README при каждом изменении установщика.

Перезапустите Claude Code после установки для активации.

## Команды

> 🚀 **Первый раз? Попробуйте сначала эти три команды**: `/blog strategy <niche>`, чтобы определить тематику блога, `/blog write <topic>`, чтобы создать первую статью (контракт с 5 воротами запускается автоматически), и `/blog analyze <file>`, чтобы оценить ее по 100-балльной шкале.

<p align="center">
  <img src="https://file.nanoskill.ai/blog-write-demo-11.gif" alt="Демонстрация /blog write в claude-blog: сквозная генерация статьи с контрактом доставки 5 ворот" width="100%">
</p>

<p align="center">
  <img src="https://file.nanoskill.ai/03-sub-skill-map-B-16.svg" alt="Экосистема поднавыков claude-blog: оркестратор в центре с 30 поднавыками, организованными в 8 тематических кластеров (написание, стратегия, качество, ИИ и поиск, мультиязычность, исследование, медиа, распространение); размеры панелей автоматически масштабируются по количеству навыков" width="100%">
</p>

| Команда | Описание |
|---------|-------------|
| `/blog write <topic>` | Написать новый пост с нуля |
| `/blog rewrite <file>` | Оптимизировать существующий пост |
| `/blog analyze <file>` | Аудит качества с оценкой 0-100 |
| `/blog brief <topic>` | Создать подробный контент-бриф |
| `/blog calendar` | Создать редакционный календарь |
| `/blog strategy <niche>` | Стратегия блога и генерация идей |
| `/blog outline <topic>` | План контента на основе SERP |
| `/blog seo-check <file>` | SEO-валидация после написания |
| `/blog schema <file>` | Создать разметку JSON-LD schema |
| `/blog repurpose <file>` | Перепрофилировать для соцсетей, email, YouTube |
| `/blog geo <file>` | Аудит готовности к цитированию ИИ |
| `/blog image [generate\|edit\|setup]` | Генерация изображений ИИ через Gemini |
| `/blog audit [directory]` | Оценка здоровья всего блога |
| `/blog cannibalization [directory]` | Обнаружение пересечения ключевых слов в постах |
| `/blog factcheck <file>` | Проверить статистику по исходным источникам |
| `/blog persona [create\|list\|apply]` | Управление персонами и голосовыми профилями |
| `/blog taxonomy [sync\|audit\|suggest]` | Управление тегами/категориями в CMS |
| `/blog notebooklm <question>` | Запрос к NotebookLM для исследования на основе источников |
| `/blog audio [generate\|voices\|setup]` | Генерация аудио-нарратива через Gemini TTS |
| `/blog google [command] [args]` | Данные API Google: PSI, CrUX, GSC, GA4, NLP, YouTube, Ключевые слова |
| `/blog cluster [plan\|execute] <seed>` | Планирование семантических тематических кластеров + выполнение (hub-and-spoke) |
| `/blog multilingual <topic> --languages <codes>` | Написание, перевод, локализация и вывод hreflang в одной команде |
| `/blog translate <file> --to <codes>` | SEO-оптимизированный перевод с сохранением форматирования |
| `/blog localize <file> --locale <code>` | Глубокая культурная адаптация для конкретной локали |
| `/blog locale-audit <directory>` | Контроль качества мультиязычного контента (полнота, hreflang, паритет, актуальность) |
| `/blog flow [find\|optimize\|win\|prompts\|sync]` | Промпты FLOW-фреймворка (на основе доказательств, 30 применимых к блогу) |
| `/blog brand [init\|show\|update]` | Генерация контекста BRAND.md + VOICE.md, автоматически загружаемого всеми поднавыками |
| `/blog discourse <topic>` | Исследование дискурса без API за последние 30 дней; создает DISCOURSE.md |

> **Всего 30 папок поднавыков**: 29 вызываемых пользователем (28 уникальных slash-команд + `/blog update` — псевдоним для rewrite) + 1 только для внутреннего использования (`blog-chart`, вызывается из blog-write/blog-rewrite для создания встроенных SVG-графиков). `blog-image` вызывается пользователем И может вызываться внутренне.

## Как claude-blog сравнивается?

claude-blog — это структурированный конвейер. Прямой запрос к LLM — одноразовый. Хостинговые SaaS-инструменты — закрытые. Вот честная матрица компромиссов:

| Возможность | claude-blog | Прямой запрос к Claude / ChatGPT | Copy.ai / Jasper | Сделать самому |
|---|:---:|:---:|:---:|:---:|
| Полная статья одной командой, с циклом итераций | ✅ (контракт 5 ворот, до 3 попыток) | ⚠️ одноразово | ✅ | ❌ |
| Статистика с источниками и проверкой | ✅ `/blog factcheck` проверяет URL источников | ❌ галлюцинирует | ❌ | ⚠️ вручную |
| Оптимизация под цитирование ИИ (GEO / AEO) | ✅ специальный аудит `/blog geo` | ❌ | ❌ | ⚠️ |
| Блокирующая рецензия контента (оценка >= 90 для доставки) | ✅ агент `blog-reviewer` | ❌ | ❌ | ❌ |
| Мультиязычность + hreflang одной командой | ✅ `/blog multilingual` | ⚠️ без hreflang | ⚠️ | ❌ |
| Планирование тематических кластеров (hub-and-spoke) | ✅ `/blog cluster` | ❌ | ⚠️ | ❌ |
| Аудио-нарратив | ✅ Gemini TTS, 30 голосов | ❌ | ❌ | ❌ |
| Генерация героического изображения (4-шаговая лестница) | ✅ Banana, Gemini, стоковые, Openverse | ❌ | ⚠️ только стоковые | ⚠️ |
| Постоянный контекст бренда и голоса | ✅ BRAND.md + VOICE.md загружаются автоматически | ❌ на каждый запрос | ⚠️ ограниченно | ❌ |
| Открытый исходный код, MIT, без платы за использование | ✅ бесплатно | ❌ подписка | ❌ подписка | ✅ |

claude-blog не лучше во всем. Прямой запрос быстрее для одноразового черновика. Хостинговый SaaS проще для нетехнических пользователей. DIY гибче для уникальных конвейеров. claude-blog подходит там, где нужен контент производственного уровня в больших объемах без подписки на SaaS.

## Возможности

### 12 шаблонов контента
Автоматически выбираются по теме и намерению: how-to гайд, список, кейс, сравнение, pillar page, обзор продукта, thought leadership, подборка, туториал, анализ новостей, исследование данных, база знаний FAQ.

### Оценка качества по 5 категориям (100 баллов)
| Категория | Баллы | Фокус |
|----------|--------|-------|
| Качество контента | 30 | Глубина, читаемость, оригинальность, вовлеченность |
| SEO-оптимизация | 25 | Заголовки, title, ключевые слова, ссылки, мета |
| Сигналы E-E-A-T | 15 | Автор, цитаты, доверие, опыт |
| Технические элементы | 15 | Schema, изображения, скорость, мобильность, OG-теги |
| Готовность к цитированию ИИ | 15 | Цитируемость, формат Q&A, ясность сущностей |

Диапазоны оценок: Исключительно (90-100), Хорошо (80-89), Приемлемо (70-79), Ниже стандарта (60-69), Переписать (<60). Контракт v1.9.0 блокирует доставку при оценке ниже 90.

### Обнаружение ИИ-контента
Оценка burstiness по вариативности длины предложений, обнаружение известных ИИ-фраз (17 фраз) и разнообразие словарного запаса (TTR). Помечает контент, который выглядит машинно-сгенерированным, до того как он попадет к рецензору.

### Написание с учетом персоны
Настраиваемые писательские персоны с 4-мерной тоновой моделью NNGroup (формально/неформально, серьезно/весело, уважительно/непочтительно, сухо/энтузиастично). Управляйте голосовыми профилями для каждого блога или автора, с диапазонами читаемости (Потребительский, Профессиональный, Технический) и принудительным соблюдением стиля при создании черновика.

### Пайплайн проверки фактов
`/blog factcheck` проверяет каждый указанный URL источника и оценивает достоверность утверждения: точное совпадение, перефраз или не найдено. Гарантирует, что каждый факт точен и отслеживаем, а не выдуман.

### Обнаружение каннибализации ключевых слов
`/blog cannibalization` выявляет пересечение ключевых слов в постах блога с помощью локального grep-анализа или API DataForSEO. Оценка серьезности и рекомендации по объединению или дифференциации предотвращают конкуренцию постов между собой в выдаче.

### Управление таксономией CMS
Синхронизация тегов и категорий с поддержкой WordPress REST, Shopify GraphQL, Ghost, Strapi и Sanity. Включает предложение тегов, синхронизацию и аудит.

### Двойная оптимизация
Каждая статья нацелена и на ранжирование в Google, и на платформы цитирования ИИ:
- **Google**: соответствие Обновлению ядра декабрь 2025, сигналы E-E-A-T, разметка schema, внутренняя перелинковка, осведомленность о Core Web Vitals через blog-google.
- **Цитирование ИИ**: Формат «сначала ответ», капсулы цитирования, цитируемость на уровне абзацев (блоки по 120-180 слов), FAQ schema, ясность сущностей.

### Визуальные медиа
- Подбор изображений из Pixabay, Unsplash и Pexels с проверкой HTTP 200 и автоматически сгенерированным alt-текстом.
- Генерация ИИ-изображений через Gemini для героических изображений, встроенных иллюстраций и социальных карточек. Требуется бесплатный ключ Google AI API.
- Встроенная генерация SVG-графиков в 7 стилях (столбчатая, сгруппированная столбчатая, леденцовая, кольцевая, линейная, с областями, радарная).
- Встраивание видео с YouTube с ленивой загрузкой `srcdoc` и запасным вариантом noscript для ИИ-краулеров.
- Показатели плотности изображений калибруются по типу контента.

### Интеграция с Google API (v1.6.5+)
13 команд на 4 уровнях учетных данных, все бесплатны при обычном использовании:
- **Уровень 0** (API key): PageSpeed Insights, CrUX Core Web Vitals (история за 25 недель), поиск видео на YouTube, NLP-анализ сущностей.
- **Уровень 1** (OAuth): данные Search Console, URL Inspection, Indexing API.
- **Уровень 2** (GA4): отчеты по органическому трафику.
- **Уровень 3** (Ads): Google Ads Keyword Planner.

### Исследование с NotebookLM
Запрос к Google NotebookLM для исследования на основе загруженных пользователем документов. Качество данных уровня Tier 1 с нулевым риском галлюцинаций, так как ответы извлекаются из загруженных вами документов.

### Аудио-нарратив
`/blog audio` генерирует аудио-нарратив через Gemini TTS. Три режима: краткое содержание (200-300 слов), полная статья, диалог двух дикторов. 30 голосов, более 80 языков.

### Поддержка платформ
Next.js MDX, Astro, Hugo, Jekyll, WordPress, Ghost, 11ty, Gatsby и статический HTML.

### Основополагающие методологии (v1.8.0)
Пять справочных документов в `skills/blog/references/` определяют редакционную и исследовательскую методологию, применяемую во всех поднавыках. Они загружаются по требованию оркестратором:

| Справочник | Назначение | Используется |
|---|---|---|
| `ai-slop-detection.md` | Двухуровневое обнаружение ИИ-контента: первый порядок (фразы) + второй порядок (структурный ритм) | `blog-rewrite`, `blog-reviewer`, `blog-analyze` |
| `editorial-heuristics.md` | 10 эвристик, адаптированных по Nielsen, с оценкой 0-4 + теги серьезности P0-P3 | `blog-analyze --rubric` |
| `cognitive-load.md` | Плотность концепций по секциям (сущности, числа, жаргон, опережающие ссылки, глубина предложений) | `blog-analyze --cognitive-load`, `scripts/cognitive_load.py` |
| `research-quality.md` | 5-мерная шкала качества исследований + 4 класса ловушек ключевых слов перед проверкой + минимальные сроки актуальности | `blog-researcher`, `blog-discourse`, `blog-brief`, `blog-strategy` |
| `synthesis-contract.md` | 6 ЗАКОНОВ, регулирующих синтез исследований (без завершающего блока Источники, внутритекстовые ссылки и т.д.) | Все поднавыки синтеза исследований |

Адаптировано из `pbakaus/impeccable` (Apache 2.0) и `mvanhorn/last30days-skill` (MIT). См. [`CONTRIBUTORS.md`](CONTRIBUTORS.md) для указания авторства.

### FLOW-фреймворк

FLOW-фреймворк (Find, Leverage, Optimize, Win) — это основанный на доказательствах рабочий процесс, общий с [`AgriciDaniel/flow`](https://github.com/AgriciDaniel/flow) (CC BY 4.0). Каждая фаза вносит промпты в конвейер оркестратора; `/blog flow` предоставляет 30 готовых к выполнению промптов, индексированных по фазам.

<p align="center">
  <img src="https://file.nanoskill.ai/04-framework-B-18.svg" alt="Радиальное колесо FLOW-фреймворка: четыре фазы (Find для поиска тем, Leverage для усиления активов, Optimize для улучшения контента, Win для конверсии читателей), расположенные вокруг центрального узла, с 10 репрезентативными промптами на внешнем кольце" width="100%">
</p>

## Контракт доставки (v1.9.0)

<p align="center">
  <img src="https://file.nanoskill.ai/02-pipeline-A-19.svg" alt="Конвейер контракта доставки блога с 5 воротами: Проверка возможностей, Полнота формата, Визуальная верификация, Обзор контента (БЛОКИРУЮЩИЕ ворота, оценка должна быть 90 или выше, без проблем P0), Целостность ресурсов и ссылок. При неудаче итерации до 3 раз перед эскалацией пользователю" width="100%">
</p>

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

| Ворота | Что проверяют | Реализация |
|---|---|---|
| 1. Проверка возможностей | Необходимые инструменты и агенты присутствуют до написания | `scripts/blog_preflight.py --gate 1` |
| 2. Полнота формата | `.md` + `.html` + `.pdf` + реальное героическое изображение | `scripts/blog_render.py`, `scripts/generate_hero.py` |
| 3. Визуальная верификация | Нет переполнения SVG, валидный JSON-LD, темная тема отображается корректно | `patchright` / `playwright` на 3 ширинах viewport |
| 4. Обзор контента (БЛОКИРУЮЩИЕ) | Оценка `blog-reviewer` 90+ И ноль проблем P0 | `agents/blog-reviewer.md` (блокирующие, v1.9.0) |
| 5. Целостность ресурсов и ссылок | Каждое изображение открывается, og:image существует, ссылки возвращают 200, wordCount в пределах 5% | `scripts/blog_preflight.py --gate 5` |

Лестница героических изображений: Banana MCP, прямой Gemini API, премиум стоковые (Unsplash, Pexels, Pixabay), публичное API Openverse. Первый доступный выигрывает. Блокировка и повтор до 3 раз при любой ошибке на воротах перед эскалацией пользователю. Полная спецификация: [`skills/blog/references/blog-delivery-contract.md`](skills/blog/references/blog-delivery-contract.md).

## Архитектура

<p align="center">
  <img src="https://file.nanoskill.ai/01-architecture-B-18.svg" alt="Системная архитектура claude-blog: конвейер слева направо от команды пользователя через маршрутизацию оркестратора, выполнение поднавыков и диспетчеризацию агентов к контракту доставки с 5 воротами перед достижением пользователя" width="100%">
</p>

claude-blog поставляется как один оркестратор плюс 29 поднавыков, 5 агентов, 21 справочник, 12 шаблонов и 9 скриптов корневого уровня. Оркестратор направляет команды пользователя к поднавыкам, которые порождают агентов и вызывают скрипты через Bash.

| Слой | Количество | Где |
|---|---:|---|
| Поднавыки (вызываемые пользователем) | 29 | `skills/blog-*/SKILL.md` |
| Поднавыки (внутренние) | 1 | `skills/blog-chart/SKILL.md` |
| Специализированные агенты | 5 | `agents/blog-*.md` |
| Справочники по требованию | 21 | `skills/blog/references/*.md` |
| Шаблоны контента | 12 | `skills/blog/templates/*.md` |
| Python-скрипты корневого уровня | 9 | `scripts/*.py` |
| Тесты | 160 | `tests/test_*.py` |

Полное дерево каталогов, диаграммы потоков данных, методология оценки и точки расширения: [`docs/ARCHITECTURE.md`](docs/ARCHITECTURE.md).

## Требования

- [Claude Code](https://docs.anthropic.com/en/docs/claude-code) CLI установлен и настроен.
- Python 3.11+ (для оценки качества, запуска контракта доставки с 5 воротами и линтинга).
- Опционально: `pip install -r requirements.txt` для расширенного анализа (оценка читаемости, обнаружение схем).

### Контроль качества (CI-enforced на каждом PR)

1. **pytest**: 160 тестов в наборах безопасности, поведенческих, регрессионных и контракта доставки.
2. **Валидация плагина**: `claude plugin validate .` плюс собственные проверки JSON/regex.
3. **Линтинг устаревших путей**: выявляет расхождения в перекрестных ссылках `references/` и `templates/`.
4. **Гигиена текста**: `scripts/lint_prose.py` (учитывает ограждения кода, обратные кавычки) обеспечивает правило CONTRIBUTING.md: без длинных тире, без коротких тире, без ` -- `.
5. **Согласованность версий**: `tests/test_version_coherence.py` проверяет, что `pyproject.toml`, `plugin.json`, `CITATION.cff` и вступление `skills/blog/SKILL.md` совпадают.
6. **Согласованность команд**: `tests/test_command_coherence.py` проверяет, что `skills/blog/SKILL.md` и `docs/COMMANDS.md` объявляют одинаковый набор команд.

Запустите локально перед отправкой:
```bash
python -m pytest tests/
python3 scripts/lint_prose.py
claude plugin validate .
```

## Часто задаваемые вопросы

### Что такое claude-blog?
claude-blog — это набор навыков Claude Code для написания, оптимизации и аудита контента блогов. Он запускает 30 поднавыков и 5 агентов через контракт доставки с 5 воротами, так что каждая статья соответствует планке качества 90/100 до того, как попадет к вам.

### Чем claude-blog отличается от прямого запроса к Claude или ChatGPT?
Прямой запрос дает вам один черновик по одному промпту. claude-blog дает вам структурированный конвейер: исследование с источниками статистики, утверждение плана, генерация черновика, многопроходная оценка качества, обнаружение ИИ-контента, проверка фактов, внедрение схемы и блокирующая рецензия, которая повторяется до 3 раз перед доставкой. Навык делает то, что в противном случае делал бы старший редактор вручную.

### Нужно ли мне членство AI Marketing Hub Pro для использования claude-blog?
Нет. Публичная версия с открытым исходным кодом по адресу [`AgriciDaniel/claude-blog`](https://github.com/AgriciDaniel/claude-blog) лицензирована MIT и бесплатна для всех, у кого есть Claude Code. Приватное зеркало `AI-Marketing-Hub/claude-blog` предназначено для участников Pro, которые хотят ранний доступ к разрабатываемым функциям и прямое сотрудничество с сообществом.

### Какие блог-платформы поддерживает claude-blog?
Next.js MDX, Astro, Hugo, Jekyll, WordPress, Ghost, 11ty, Gatsby и статический HTML. Оркестратор автоматически определяет платформу по сигналам проекта и соответствующим образом настраивает frontmatter, встраивание изображений и внедрение схемы.

### Галлюцинирует ли claude-blog статистику?
Нет. Каждая цитируемая статистика проходит через `/blog factcheck`, который проверяет URL источника и оценивает достоверность утверждения (точное совпадение, перефраз, не найдено). Агент `blog-reviewer` блокирует публикацию, если цитату невозможно проверить или если обнаружение ИИ-контента помечает текст как машинно-сгенерированный.

### Что такое Контракт доставки блога с 5 воротами?
Это программно-принудительный конвейер предварительного представления, который запускается для каждого черновика: Проверка возможностей, Полнота формата, Визуальная верификация на 3 ширинах viewport, Обзор контента (БЛОКИРУЮЩИЕ; оценка 90+ и ноль P0), Целостность ресурсов и ссылок. Оркестратор повторяет работу автора до 3 раз при любой ошибке на воротах перед эскалацией вам. Полная спецификация в [`skills/blog/references/blog-delivery-contract.md`](skills/blog/references/blog-delivery-contract.md).

### Могу ли я использовать claude-blog на нескольких языках?
Да. `/blog multilingual <topic> --languages en,de,fr,es,ja` пишет пост, переводит его с сохранением frontmatter и схемы, выполняет глубокую культурную адаптацию для каждой локали и выдает теги hreflang плюс готовую для CMS языковую карту в одной команде.

### Как цитировать claude-blog в академических работах?
См. раздел [Как цитировать](#как-цитировать) ниже или файл [`CITATION.cff`](CITATION.cff) в корне репозитория. GitHub отображает структурированный файл цитирования через кнопку «Cite this repository» на странице публичного зеркала.

### Безопасно ли устанавливать claude-blog?
Установщик содержит только Python-скрипты и файлы Markdown, никогда не выполняет удаленный код за пределами того, что приносит `pip install -r requirements.txt`, и проверяется на соответствие политике [`SECURITY.md`](SECURITY.md) проекта при каждом изменении. Способ установки с клонированием и переходом на тег позволяет вам проверить `install.sh` перед запуском. См. [`SECURITY.md`](SECURITY.md) для полной модели угроз.

## Дорожная карта

<p align="center">
  <img src="https://file.nanoskill.ai/05-roadmap-A-17.svg" alt="Волновая дорожная карта claude-blog на горизонтальной шкале времени: v1.6.0 основа (март 2026), v1.7.0 FLOW-фреймворк (апр 2026), v1.8.0 безупречная методология (май 2026), v1.9.0 контракт доставки (текущая, май 2026), v2.0.0 мульти-CMS публикация (3 кв. 2026), v3.0.0 блог-как-код (1 кв. 2027)" width="100%">
</p>

**v1.9.1 (следующая)**
- Общая функция `_count_body_words(html)` между `blog_render` и `blog_preflight` для устранения остаточного аудита v1.9.0.
- Семантика кодов выхода `generate_hero.py`: ненулевой при отсутствии пути генерации изображения (сейчас возвращает ошибку JSON с кодом 0).
- Тест покрытия цикла итераций, проверяющий, что оркестратор эскалирует после 3 БЛОКИРОВОК рецензора, а не 4.
- Проверка оставшихся документов (CONTRIBUTORS, NOTICE, SECURITY, PRIVACY, TEMPLATES, TROUBLESHOOTING, MCP-INTEGRATION, DEMO) на остаточный дрейф слоя v1.x.

**v1.10 (видение)**
- Живое уточнение плана на основе SERP через DataForSEO во время написания.
- Набор для оценки качества блога в разных конфигурациях (наличие BRAND.md, вариант персоны, мультиязычный режим).
- Программно-принудительный счетчик итераций (сейчас инструкция оркестратора; повысить до уровня скрипта).

**v2.0 (долгосрочно)**
- Интеграция сервера предварительного просмотра без пользовательского интерфейса: контракт с 5 воротами работает с реальным доменом предварительного просмотра вместо локального HTML.
- Коннекторы публикации для каждой CMS (WordPress, Ghost, Sanity) с идемпотентной повторной публикацией при переписывании.
- Панель отслеживания цитирования ИИ в реальном времени (какие посты цитируются ChatGPT, Perplexity, AI Overviews; тепловая карта видимости).

Откройте issue с меткой `roadmap`, если хотите предложить что-то или проголосовать.

## Удаление

Unix/macOS:
```bash
chmod +x uninstall.sh && ./uninstall.sh
```

Windows (PowerShell):
```powershell
.\uninstall.ps1
```

## Интеграция

Генерация графиков и встраивание видео с YouTube встроены. Данные Google API требуют бесплатного ключа API (см. `/blog google setup`).

**Опциональные сопутствующие навыки** (более глубокий анализ опубликованных страниц):

| Навык | Интеграция |
|-------|-------------|
| `/seo` | Глубокий SEO-анализ опубликованных страниц блога |
| `/seo-schema` | Валидация и генерация разметки schema |
| `/seo-geo` | Аудит оптимизации под цитирование ИИ |
| `/seo-google` | Данные Google API (общая конфигурация с blog-google) |

## Документация

Подробная документация находится в [`docs/`](docs/):

- [Руководство по установке](docs/INSTALLATION.md): Unix, macOS, Windows, ручная установка.
- [Справочник команд](docs/COMMANDS.md): Полный справочник команд с примерами.
- [Архитектура](docs/ARCHITECTURE.md): Проектирование системы и обзор компонентов.
- [Рабочий процесс публикации](docs/PUBLISHING.md): Поток приватного-публичного релиза (для мейнтейнеров Pro).
- [Шаблоны](docs/TEMPLATES.md): Справочник шаблонов и их настройка.
- [Устранение неполадок](docs/TROUBLESHOOTING.md): Частые проблемы и решения.
- [Интеграция с MCP](docs/MCP-INTEGRATION.md): Опциональная настройка MCP-сервера.

## Как цитировать

Если вы используете claude-blog в исследованиях или на продакшене, пожалуйста, цитируйте проект:

```bibtex
@software{Agrici_claude_blog_2026,
  author       = {Агричи, Даниэль},
  title        = {claude-blog: Навык написания и SEO-оптимизации блогов с ИИ для Claude Code},
  year         = {2026},
  url          = {https://github.com/AgriciDaniel/claude-blog},
  version      = {1.9.0},
  license      = {MIT}
}
```

GitHub также отображает структурированный файл [`CITATION.cff`](CITATION.cff) через «Cite this repository» на странице публичного зеркала.

## Безопасность и Кодекс поведения

- **Политика безопасности + модель угроз**: [`SECURITY.md`](SECURITY.md). Усиление v1.8.x закрыло все известные находки; v1.9.0 добавляет XSS-безопасный JSON-LD, отказ от симлинков с O_NOFOLLOW и валидацию frontmatter, всё проверено мутационным тестированием. Чтобы сообщить об уязвимости конфиденциально, следуйте процедуре раскрытия в [`SECURITY.md`](SECURITY.md).
- **Кодекс поведения**: [`CODE_OF_CONDUCT.md`](CODE_OF_CONDUCT.md). Contributor Covenant. Будьте вежливы друг с другом.

## Вклад

Приветствуется вклад. См. [`CONTRIBUTING.md`](CONTRIBUTING.md) для руководств. Перед открытием PR:

1. Запустите `python -m pytest tests/` (все 160 должны пройти).
2. Запустите `python3 scripts/lint_prose.py --root .` (ноль нарушений).
3. Запустите `claude plugin validate .` (должен пройти).
4. Обновите версии согласованно, если затрагиваете видимые пользователю счетчики или поведение (см. [`docs/PUBLISHING.md`](docs/PUBLISHING.md)).

## Лицензия

Лицензия MIT. Подробнее см. [`LICENSE`](LICENSE).

## Связанные проекты

- **[Rankenstein](https://rankenstein.pro)**: GUI-ориентированный рабочий процесс публикации контента; от исследования до публикации в одной платформе.
- **[FLOW-фреймворк](https://github.com/AgriciDaniel/flow)**: Промпты Find, Optimize, Win на основе доказательств (CC BY 4.0). Интегрирован как поднавык через `/blog flow`.
- **[Claude Ads](https://github.com/AgriciDaniel/claude-ads)** и **[Claude SEO](https://github.com/AgriciDaniel/claude-seo)**: родственные навыки, разделяющие один фирменный набор (баннер + диаграммы, созданные с оранжевой палитрой бренда).
- **[AI Marketing Hub](https://www.skool.com/ai-marketing-hub)**: Бесплатное сообщество, 2800+ участников. Уровень Pro на [`ai-marketing-hub-pro`](https://www.skool.com/ai-marketing-hub-pro) размещает приватное зеркало этого навыка.

## История звезд

<a href="https://star-history.com/#AgriciDaniel/claude-blog&Date">
  <picture>
    <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=AgriciDaniel/claude-blog&type=Date&theme=dark" />
    <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=AgriciDaniel/claude-blog&type=Date" />
    <img alt="История звезд AgriciDaniel/claude-blog на GitHub" src="https://api.star-history.com/svg?repos=AgriciDaniel/claude-blog&type=Date" />
  </picture>
</a>

Если claude-blog экономит ваше время, звезда на [публичном репозитории](https://github.com/AgriciDaniel/claude-blog) — самый простой способ сказать спасибо (и помогает другим контент-специалистам найти его).

## Автор

Создано [Даниэлем Агричи](https://agricidaniel.com/about), архитектором рабочих процессов ИИ, с помощью Claude Code.

- [Блог](https://agricidaniel.com/blog): Глубокие погружения в автоматизацию маркетинга с ИИ.
- [YouTube](https://www.youtube.com/@AgriciDaniel): Туториалы и демонстрации.
- [Все инструменты с открытым исходным кодом](https://github.com/AgriciDaniel): Другие навыки Claude Code.
- [AI Marketing Hub](https://www.skool.com/ai-marketing-hub): Бесплатное сообщество маркетинга на основе ИИ.

## FAQ

### Что такое навык claude-blog?

claude-blog — это набор навыков Claude Code, предназначенный для написания, оптимизации и аудита контента блогов в больших масштабах. Он гарантирует, что каждая статья оптимизирована одновременно для рейтинга в Google и платформ цитирования ИИ.

### Для кого предназначен этот навык написания блогов с ИИ?

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

### Как работает 5-этапный контракт поставки?

5-этапный контракт поставки оценивает каждый черновик по 100-балльной шкале по критериям: Возможности, Формат, Визуальное оформление, Проверка контента и Целостность ресурсов. Любой черновик с оценкой ниже 90 блокируется, и автор дорабатывает его до трех раз, прежде чем передать на ваше рассмотрение.

### Какой контент создает claude-blog?

Он создает 8 артефактов в одной папке, включая файл Markdown с заголовком, описанием, датой, автором, тегами и каноническим URL, а также сгенерированный HTML, PDF, главные изображения, скриншоты, оценочную карту и предварительный аудиторский отчет.

### Может ли этот навык работать с многоязычным контентом?

Да, он поддерживает многоязычную публикацию одной командой, включая написание, перевод, локализацию и генерацию hreflang. Он также предлагает оптимизированный для SEO перевод с сохранением форматирования и глубокой культурной адаптацией для каждого региона.

### Как claude-blog обеспечивает качество и точность контента?

Он использует систему оценки качества по 5 категориям, обнаружение ИИ-контента для пометки машинно-сгенерированного текста, персонализированное письмо с принудительным соблюдением стиля, а также конвейер проверки фактов, сверяющий статистику с указанными источниками.
