name: writing-content description: | Интерактивный процесс написания текстов для вайб-маркетинга на основе Julian Shapiro framework.

Новые возможности (v2.0):

Research & Gap Analysis (Perplexity → WebSearch fallback)
Scoring 0-5 вместо binary (Novelty + Resonance + Hook + Clarity)
AI-Slop Detection на всех этапах (10 типов patterns)
3 варианта intro с self-scoring
Markdown export всех промежуточных результатов

Русские triggers: "напиши пост по шапиро", "написать статью по фреймворку шапиро", "создай текст в стиле julian shapiro", "помоги написать контент по методу shapiro", "контент по julian shapiro фреймворку", "пост по julian shapiro", "напиши в стиле шапиро"

English triggers: "write content using julian shapiro framework", "create post with shapiro method", "write article shapiro style", "help with julian shapiro writing"

Generic triggers: "напиши статью", "помоги написать контент", "создай текст", "начать писать", "хочу написать пост", "нужна помощь с текстом", "write content", "write article", "создай контент", "придумай идею для статьи", or requests help with content creation process.

Writing Content — Интерактивное написание текстов

Workflow Routing (SYSTEM PROMPT)

CRITICAL: This section routes EVERY workflow. Always read the appropriate workflow file.

Этап 1: Генерация идеи (v2 - с Research + Scoring 0-5)

Когда пользователь говорит: Examples: "придумай идею", "о чём писать", "start writing", "начать писать", "хочу написать о...", "нужна идея для статьи", "помоги с темой", "что написать"

→ READ: ~/.claude/skills/writing-content/workflows/1-generate-idea.md → PREREQUISITES:

tools/scoring-system.md (scoring methodology)
references/scoring-criteria.md (0-5 criteria with examples)

→ EXECUTE:

Интерактивная генерация идеи
Research & Gap Analysis (NEW)
- Perplexity search (fallback к WebSearch)
- Identify content gap
Scoring 0-5 (NEW вместо binary)
- Novelty: 0-5 с reasoning + evidence + improvement
- Resonance: 0-5 с reasoning + evidence + improvement
- Overall recommendation (strong proceed | proceed | revise | rethink)
Markdown Export (NEW)
- Создать writing-session-{timestamp}.md в current directory
- Section: "Идея" с research + scoring + improvements
Decision: proceed/revise/rethink based on scores

Этап 2: Написание intro (v2 - 3 варианта + AI-Slop Check)

Когда пользователь говорит: Examples: "напиши первый абзац", "создай intro", "write hook", "напиши вступление", "сделай зацепляющее начало", "начало статьи"

→ READ: ~/.claude/skills/writing-content/workflows/2-write-intro.md → PREREQUISITES:

references/hooks-database.md (4 hook types + viral patterns)
tools/scoring-system.md
tools/anti-ai-detector.md
references/ai-slop-patterns.md

→ EXECUTE:

Load hooks database
Generate 3 variants (NEW вместо 1)
- Variant 1: Question Hook
- Variant 2: Narrative Hook
- Variant 3: Argument Hook
Self-Score каждый вариант (NEW)
- Hook Strength: 0-5
- Clarity: 0-5
- AI-Slop Score: 0-5 (detection + fixes)
- Overall: average
AI-Slop Fixes (NEW)
- Threshold: >= 4/5 mandatory
- Apply fixes if needed, re-score
Present all 3 variants with scores + recommendation
Markdown Export (NEW)
- Append section: "Intro" (all 3 variants + selected)

Этап 3: Тестирование через AI-персоны

Когда пользователь говорит: Examples: "протестируй intro", "test intro", "проверь идею", "оцени intro", "как зайдёт этот текст", "протестируй на аудитории", "проверь как зацепит"

→ READ: ~/.claude/skills/writing-content/workflows/3-test-with-personas.md → EXECUTE: Создание 3 AI-персон (core/skeptical/novice) и симуляция чтения intro

Этап 4: Полная статья (v2 - с AI-Slop Check)

Когда пользователь говорит: Examples: "напиши полную статью", "expand to article", "write full post", "сделай большой текст", "разверни в статью", "пиши полностью"

→ READ: ~/.claude/skills/writing-content/workflows/4-write-full-article.md → PREREQUISITES:

tools/anti-ai-detector.md
references/ai-slop-patterns.md

→ EXECUTE:

Create outline (supporting/resulting points)
Draft section by section
AI-Slop Check (NEW)
- Run detection on draft
- Apply fixes if score < 4
Markdown Export (NEW)
- Append section: "Drafting" (objective + outline + draft + AI check)

Этап 5: Переписывание для ясности (v2 - с AI-Slop Check)

Когда пользователь говорит: Examples: "улучши текст", "rewrite", "сделай понятнее", "переписать", "упрости язык", "сделай короче и яснее"

→ READ: ~/.claude/skills/writing-content/workflows/5-rewrite-clarity.md → PREREQUISITES:

tools/anti-ai-detector.md

→ EXECUTE:

Clarity pass
Succinctness pass (verbal summary)
Intrigue pass (dopamine hits)
AI-Slop Check After Rewrite (NEW)
- CRITICAL: Check if rewrite made text MORE AI-like
- Compare original vs rewritten scores
- Revert problematic changes if needed
Markdown Export (NEW)
- Append section: "Rewriting" (stats + rewritten text + AI check)

Этап 6: Стиль и полировка (v2 - усиленный AI-Slop Detection)

Когда пользователь говорит: Examples: "добавь стиль", "polish", "финальная версия", "сделай красиво", "добавь личности", "улучши voice"

→ READ: ~/.claude/skills/writing-content/workflows/6-style-polish.md → PREREQUISITES:

tools/anti-ai-detector.md
references/ai-slop-patterns.md

→ EXECUTE:

AI-Slop Detection (10 red flags - УСИЛЕННАЯ ПРОВЕРКА)
- Contrast framing, Rule of three, Cringe transitions
- Present-ing verbs, Vague opinions, Formal language
- Emoji explosion, Extra em dashes, Symbolic language, Fake personas
- Threshold: >= 4/5 MANDATORY
Voice check (authentic, conversational)
Vividness (живые детали, метафоры)
Poetry (optional, second-order descriptions)
Markdown Export (NEW)
- Append final section: "Polishing" (AI-Slop fixes + style improvements + final text)
- sync_status: "complete"

Этап 7: Генерация визуала (v2 - unchanged from v1, integrated with art skill)

Когда пользователь говорит: Examples: "создай картинку", "нужен визуал", "generate image", "add visual", "сделай иллюстрацию", "нужна картинка к статье"

→ READ: ~/.claude/skills/writing-content/workflows/7-generate-visual.md → EXECUTE:

Активация art skill для создания визуала
Сохранение в state
(Markdown export если markdown файл уже создан)

Продолжение работы

Когда пользователь говорит: Examples: "продолжить статью", "где мы остановились", "continue writing", "что дальше", "вернуться к статье"

→ LOAD STATE: ~/.claude/skills/writing-content/state/current-article.json → EXECUTE: Загрузить контекст и продолжить с последнего этапа

Architecture & Design

Skill Type Classification

Complex Archetype — Sophisticated multi-workflow system with external integrations and progressive state management

Canonical Reference: ~/.claude/skills/CORE/SKILL-STRUCTURE-AND-ROUTING.md

Core Innovation (v2.0)

This skill combines three frameworks:

Julian Shapiro Writing Framework (Novelty × Resonance = Quality)
AI-Slop Detection System (10-layer pattern recognition across 4 dimensions)
Progressive Markdown Export (Dual state: JSON + human-readable markdown)

Integration Architecture

State Management Model:

Source of Truth:    state/current-article.json (v2 structure)
                           ↓
                    (synchronization)
                           ↓
Human Interface:    writing-session-{timestamp}.md (progressive append)

State Evolution:

v1 → v2 migration: Added research, 0-5 scoring, 3 intro variants, markdown export tracking
Backward compatibility: v1 state files still readable (progressive disclosure)
Sync mechanism: Automatic after each workflow step completion

Workflow Dependency Graph

Prerequisites (read first):
├── references/
│   ├── hooks-database.md         → Workflow 2 (intro generation)
│   ├── scoring-criteria.md       → Workflows 1, 2 (0-5 criteria)
│   └── ai-slop-patterns.md       → Workflows 2, 4, 5, 6 (detection)
├── tools/
│   ├── scoring-system.md         → Workflows 1, 2 (methodology)
│   ├── anti-ai-detector.md       → Workflows 2, 4, 5, 6 (algorithm)
│   └── markdown-exporter.md      → Workflows 1, 2, 4, 5, 6 (export)
└── state/
    └── README.md                 → All workflows (state structure)

Workflow execution order:
1-generate-idea (v2) → 2-write-intro (v2) → 3-test-personas →
4-write-article (v2) → 5-rewrite-clarity (v2) → 6-style-polish (v2) →
7-generate-visual

Key v2.0 Additions

1. Research & Gap Analysis (Workflow 1)

Method: Perplexity search → WebSearch fallback
Purpose: Identify content gaps before writing
Output: idea.research object in state

2. 0-5 Scoring System (Workflows 1, 2)

Replaces: Binary yes/no evaluation
Parameters: Novelty, Resonance, Hook Strength, Clarity, AI-Slop Score
Structure: { score: 0-5, reasoning: string, evidence: string, improvement: string }
Decision Thresholds:
- = 4 both: Strong Proceed
- = 3 both: Proceed
- < 3 either: Revise/Rethink

3. 3 Intro Variants with Self-Scoring (Workflow 2)

Variants: Question Hook, Narrative Hook, Argument Hook
Each scored independently: Hook Strength, Clarity, AI-Slop
Selection: User chooses based on scores + recommendation
State: intro.variants[] array with 3 objects

4. AI-Slop Detection (4 Layers, All Workflows)

Layer 1: Lexical Scan — Red/Yellow flag words (32 patterns)
Layer 2: Structural Scan — Perfect structure, transition overload, list mania
Layer 3: Tonal Scan — Безликость, formality, fake enthusiasm
Layer 4: Sentence Patterns — Contrast framing, -ing verbs, hedging
Threshold: >= 4/5 mandatory for all workflows
Critical Check (Workflow 5): Ensures rewriting doesn't ADD AI patterns

5. Progressive Markdown Export (All Workflows)

File: writing-session-{YYYY-MM-DD-HHMMSS}.md in current directory
Sections: Idea → Intro → Testing → Drafting → Rewriting → Polishing
Append-only: Each workflow appends its section
Sync tracking: article.markdown_export.sections_written[] array
Completion: sync_status: "complete" when workflow 6 finishes

External Integrations

Skills:

art skill — Visual generation (Workflow 7)
research skill (optional) — Enhanced data gathering

Search Services:

Perplexity (primary) — Research & gap analysis
WebSearch (fallback) — If Perplexity unavailable

Capabilities Matrix

Capability	Workflows	New in v2.0
Idea Generation	1	✅ Research + 0-5 scoring
Hook Creation	2	✅ 3 variants + self-scoring
AI-persona Testing	3	(unchanged)
Full Drafting	4	✅ AI-Slop detection
Clarity Rewriting	5	✅ AI-Slop check after rewrite
Style Polishing	6	✅ Enhanced 10-pattern detection
Visual Generation	7	(unchanged)
State Persistence	All	✅ Dual JSON + Markdown
Progress Tracking	All	✅ Markdown export sync

When to Activate This Skill

Direct Writing Requests (Categories 1-4)

"напиши статью", "write article", "создай контент", "write post"
"помоги написать", "нужна помощь с текстом", "assist with writing"
"начать писать", "start writing", "создать текст", "compose content"
"напиши о [тема]", "write about [topic]", "статья про [тема]"

Idea Generation (Category 5)

"придумай идею", "generate idea", "о чём писать", "what to write about"
"нужна тема для статьи", "find topic", "help with topic"
"что написать", "suggest topic", "мне нужна идея"

Content Testing (Category 6)

"протестируй контент", "test content", "проверь текст", "validate idea"
"как зайдёт текст", "оцени intro", "evaluate hook"
"проверь на аудитории", "test with audience"

Content Improvement (Category 7)

"улучши текст", "improve writing", "rewrite", "переписать"
"сделай понятнее", "make clearer", "упрости", "simplify"
"добавь стиль", "add style", "polish", "финальная версия"

Visual Content (Category 8)

"создай картинку", "generate visual", "нужна иллюстрация"
"add image", "create diagram", "сделай визуал"

Core Capabilities

Что даёт этот skill:

Генерация идей — Интерактивная помощь в поиске темы с валидацией по 5 типам novelty (Julian Shapiro)
Написание hooks — Создание зацепляющих первых абзацев по проверенной структуре
AI-тестирование — Симуляция реакции 3 типов аудитории за 2 минуты (vs 24+ часов реального теста)
Полная статья — Структурированное написание с outline, supporting/resulting points
Переписывание — Улучшение clarity, succinctness, intrigue
Стилизация — Добавление voice, vividness, authentic tone
Визуальный контент — Интеграция с art skill для генерации иллюстраций

Core Principles (Julian Shapiro Framework)

Writing Quality = Novelty × Resonance

Novelty (Draft 1):

Counter-intuitive — То, что противоречит общепринятому
Counter-narrative — Против популярного нарратива
Shock and awe — Неожиданные факты/статистика
Elegant articulations — Красиво сформулированные идеи
Make someone feel seen — Описать чувство, которое человек испытывает но не может выразить

Resonance (Draft 2+):

Stories — Истории делают идеи запоминающимися
Analogies — Сравнения помогают понять сложное
Examples — Конкретные примеры вместо абстракций
Authentic voice — Пиши как говоришь с другом

The Process

Choose topic + objective — Что хочешь донести?
Write intro with hook — Зацепи с первой строки
Test with AI personas — Мгновенная валидация на 3 типах аудитории
Write full article — Outline → draft по структуре
Rewrite — Clarity + succinctness + intrigue
Polish — Voice + vividness + poetry
Add visual (optional) — Иллюстрация через art skill

Workflow Overview

Последовательные этапы:

1-generate-idea.md — Генерация и валидация идеи
- Интервью с пользователем (аудитория, проблема, инсайт)
- Валидация по 5 типам novelty
- Формулировка идеи в 1 предложение
2-write-intro.md — Написание зацепляющего intro
- Выбор типа hook (question/narrative/research/argument)
- Создание 3 вариантов hooks
- Написание полного intro (3-5 предложений)
3-test-with-personas.md — Тестирование через AI-персоны
- Создание 3 архетипов (Core/Skeptical/Novice)
- Stream of consciousness reading (естественные мысли при чтении)
- Aggregated score + рекомендации
4-write-full-article.md — Написание полной статьи
- Создание outline (supporting/resulting points)
- Drafting по секциям
- Conclusion с takeaway
5-rewrite-clarity.md — Переписывание для ясности
- Clarity (простой язык для 13-летнего)
- Succinctness (verbal summary, убрать filler)
- Intrigue (dopamine hits, withholding info)
6-style-polish.md — Финальная стилизация
- Voice (authentic, как говоришь с другом)
- Vividness (живые детали, метафоры)
- Poetry (second-order descriptions)
7-generate-visual.md — Генерация визуала
- Выбор типа визуала
- Интеграция с art skill
- Сохранение результата

State Management

Все данные сохраняются в: ~/.claude/skills/writing-content/state/current-article.json

Структура state:

{
  "id": "uuid",
  "created": "timestamp",
  "updated": "timestamp",
  "status": "idea|intro|testing|drafting|rewriting|polishing|complete",
  "idea": {
    "rawIdea": "string",
    "refinedIdea": "string",
    "audience": "string",
    "problem": "string",
    "noveltyType": "counter-intuitive|counter-narrative|shock-awe|elegant|make-seen"
  },
  "intro": {
    "hook": "string",
    "hookType": "question|narrative|research|argument",
    "fullIntro": "string",
    "version": 1
  },
  "persona_test_results": {
    "personas": [...],
    "aggregate_score": 0-100,
    "recommendation": "proceed|revise|rethink"
  },
  "article": {
    "objective": "string",
    "outline": ["string"],
    "draft": "string",
    "rewritten": "string",
    "final": "string"
  },
  "visual": {
    "requested": true,
    "type": "string",
    "image_url": "string",
    "alt_text": "string"
  }
}

Можно продолжить в любой момент:

"продолжить статью"
"где мы остановились?"
"continue writing"

Examples

Example 1: От идеи до тестирования

User: "Хочу написать статью про email-маркетинг"

Claude: [Загружает workflow 1-generate-idea.md]

Отлично! Давай проработаем идею.

1. Для кого эта статья? (твоя целевая аудитория)
2. Какую проблему они пытаются решить?
3. Какой инсайт/неожиданный подход ты можешь дать?

User: "Для маркетеров B2B SaaS. Они пишут emails но люди не читают."

Claude:

Хм, интересно. Что если...

💡 Идея: "Большинство маркетеров пишут email неправильно - они думают главное это информация, но на самом деле главное это первая строка."

Это counter-intuitive ✅ (против того что все думают)

Хочешь доработать или двигаемся дальше?

User: "Давай напишем intro"

Claude: [Автоматически переходит к workflow 2-write-intro.md]

Отлично! Выбери тип hook:

1. Question: "Почему люди не читают твои email?"
2. Narrative: "Вчера я отправил 100 email. Открыли 5."
3. Research: "Исследование показало: 80% email удаляют не читая."

Какой зацепит твою аудиторию?

User: "Давай протестируем intro"

Claude: [workflow 3-test-with-personas.md]

Создаю 3 персоны для теста...

👤 Алексей (Core) - Head of Marketing, 32 года
👤 Мария (Skeptical) - CMO, опыт 10 лет
👤 Дмитрий (Novice) - Junior маркетолог, 1 год

Симулирую чтение intro...

[Stream of consciousness от каждой персоны]

📊 РЕЗУЛЬТАТ: 78% (ХОРОШО)
✅ Можно переходить к полной статье

Example 2: Возврат к незавершённой статье

User: "Продолжить статью"

Claude: [Загружает state/current-article.json]

Нашёл твою статью:

📄 "Email-маркетинг: первая строка решает всё"
📊 Статус: testing (AI-персоны дали 78%)
🎯 Рекомендация: Переходим к написанию полной статьи

Хочешь продолжить?

Example 3: Только улучшение текста

User: "Переписать текст понятнее" [+ текст]

Claude: [workflow 5-rewrite-clarity.md]

Анализирую текст...

❌ Проблемы:
- Сложный язык (13-летний не поймёт)
- Много filler words ("в принципе", "так сказать")
- Abstract phrases без примеров

Переписываю...

[Показывает до/после для каждой секции]

Extended Context

Related Skills Integration

Интеграция с другими skills:

art skill — Генерация визуалов для статьи (workflow 7)
research skill (если доступен) — Поиск данных/статистики для novelty
blogging skill (если доступен) — Публикация готовой статьи

Julian Shapiro Resources

Этот skill основан на материалах:

Julian Shapiro/1. Writing Handbook - What to Write About
Julian Shapiro/2. Writing First Drafts
Julian Shapiro/3. Rewriting and Editing
Julian Shapiro/4. Writing Style
Julian Shapiro/5. Practicing Writing

Полный путь: ~/Documents/obsidian-vault/3. projects/Active/Vibemarketing/content-creation/Julian Shapiro/

Testing Framework

Оригинальный pipeline тестирования (для справки): ~/Documents/obsidian-vault/3. projects/Active/Vibemarketing/content-creation/TESTING_CONTENT_IDEAS.md

Этот skill использует AI-персоны вместо реального тестирования для скорости (2 мин vs 24+ часов).

Key Principles

1. Интерактивность превыше всего

Всегда задавай вопросы
Не делай за пользователя — помогай
Дай выбор на критичных моментах

2. State = память скилла

Сохраняй после каждого workflow
Можно вернуться в любой момент
История изменений (versions)

3. Следуй Julian Shapiro строго

Не изобретай свои методы
Используй термины из материалов
Novelty × Resonance — основа качества

4. AI-персоны звучат естественно

Stream of consciousness (думают вслух)
Filler words ("хм", "ок", "блин")
Эмоциональные реакции
Личные связи ("я так делаю")

Related Documentation:

~/.claude/skills/CORE/SKILL-STRUCTURE-AND-ROUTING.md — Canonical structure guide
~/Documents/obsidian-vault/3. projects/Active/Vibemarketing/content-creation/ — Vibemarketing content resources

Last Updated: 2025-11-25

ナビゲーション

Skillsとは？

リンク

writing-content

Writing Content — Интерактивное написание текстов

Workflow Routing (SYSTEM PROMPT)

Этап 1: Генерация идеи (v2 - с Research + Scoring 0-5)

Этап 2: Написание intro (v2 - 3 варианта + AI-Slop Check)

Этап 3: Тестирование через AI-персоны

Этап 4: Полная статья (v2 - с AI-Slop Check)

Этап 5: Переписывание для ясности (v2 - с AI-Slop Check)

Этап 6: Стиль и полировка (v2 - усиленный AI-Slop Detection)

Этап 7: Генерация визуала (v2 - unchanged from v1, integrated with art skill)

Продолжение работы

Architecture & Design

Skill Type Classification

Core Innovation (v2.0)

Integration Architecture

Workflow Dependency Graph

Key v2.0 Additions

External Integrations

Capabilities Matrix

When to Activate This Skill

Direct Writing Requests (Categories 1-4)

Idea Generation (Category 5)

Content Testing (Category 6)

Content Improvement (Category 7)

Visual Content (Category 8)

Core Capabilities

Core Principles (Julian Shapiro Framework)

Writing Quality = Novelty × Resonance

The Process

Workflow Overview

State Management

Examples

Example 1: От идеи до тестирования

Example 2: Возврат к незавершённой статье

Example 3: Только улучшение текста

Extended Context

Related Skills Integration

Julian Shapiro Resources

Testing Framework

Key Principles

1. Интерактивность превыше всего

2. State = память скилла

3. Следуй Julian Shapiro строго

4. AI-персоны звучат естественно

関連スキル(⚙️ DevOps)