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

story-sense — скилл для Claude Code: диагностика проблем в тексте

Скилл разбирает, в каком состоянии находится ваша история и что ей мешает двигаться дальше. Для писателей, которые застряли и не понимают почему.

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

Что делает story-sense

story-sense — диагностический скилл для художественной прозы. Он не пишет текст за вас, а определяет, на каком этапе вы застряли: пустая страница, тонкий мир, плоские персонажи, провисающий темп, слабая концовка, незавершённый черновик. По симптомам скилл ставит диагноз и направляет к нужному инструменту из набора.

Внутри — модель состояний от State 0 до State 7, дерево решений и два скрипта на Deno: entropy.ts подбрасывает случайные идеи из списков (lies, ghosts, disasters, dilemmas), а functions.ts собирает персонажей из абстрактных ролей вроде healer или keeper_of_secrets. Скрипты запускаются через deno run --allow-read.

Скилл намеренно не даёт готовых решений сразу. Сначала уточняющие вопросы, потом один инструмент, потом переоценка. Если вы ждёте, что агент просто напишет сцену, это не сюда — для этого есть story-collaborator. Для работы скриптов нужен установленный Deno.

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

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

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

  • Моя история застряла, помоги понять, что не так
  • Персонажи кажутся плоскими, хотя сюжет продуман — что чинить?
  • Запусти entropy.ts и подкинь пару идей для поворота

Как установить story-sense

1Через Skills CLI (Vercel)

npx skills add jwynia/agent-skills --skill story-sense -a claude-code

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

~/.claude/skills/story-sense/SKILL.md

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

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

Вопросы о story-sense

Как установить story-sense в Claude?

Выполните npx skills add jwynia/agent-skills --skill story-sense -a claude-code. Скилл появится в ~/.claude/skills/story-sense/SKILL.md.

Что делает story-sense?

Определяет состояние вашей истории по симптомам и рекомендует конкретный инструмент для следующего шага. Работает как диагностика, а не как генератор текста.

Чем story-sense отличается от story-collaborator?

story-sense только ставит диагноз и указывает направление. Если нужно, чтобы агент писал вместе с вами, используйте story-collaborator.

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

SKILL.md · MIT
---
name: story-sense
description: "Diagnose what any story needs regardless of its current state. This skill should be used when a writer is stuck, evaluating story problems, when narrative feels broken, or when someone asks 'what's wrong with my story?'. Keywords: story, diagnosis, stuck, narrative, plot, character, worldbuilding, revision."
license: MIT
compatibility: Works with any fiction format. Entry point for fiction diagnostics.
metadata:
  author: jwynia
  version: "1.0"
  type: diagnostic
  mode: diagnostic
  domain: fiction
---

# Story Sense: Diagnostic Skill

Identify what state a story is in and what it needs to move forward. This is not a linear process but a diagnostic model: Assess → Diagnose → Intervene → Reassess.

## When to Use This Skill

Use this skill when:
- Writer is stuck and doesn't know why
- Story feels broken but root cause unclear
- Need to evaluate story problems systematically
- Someone asks "what's wrong with my story?"

Do NOT use this skill when:
- Writer wants you to write the story (use story-collaborator)
- Writer wants coaching questions only (use story-coach)
- Publishing/marketing questions (use book-marketing)

## Core Principle

**Story Sense is the ability to know what any story needs, regardless of its current state or intended medium.**

**There's no such thing as "stuck."** There's only:
- Not yet having diagnosed the problem
- Not yet applying the right intervention

## The Story States

### State 0: No Story (Blank Page)
**Symptoms:** Nothing exists yet
**Interventions:** story-idea-generator, elemental genres

### State 1: Concept Without Foundation
**Symptoms:** Have idea but world/characters/plot feel thin
**Interventions:** cliche-transcendence, systemic-worldbuilding, key-moments

### State 2: World Without Life
**Symptoms:** Setting exists but feels like backdrop
**Interventions:** worldbuilding skill suite (belief-systems, economic-systems, governance-systems)

### State 3: Flat Non-Humans
**Symptoms:** Aliens/fantasy species feel like humans in costume
**Interventions:** conlang, species development frameworks

### State 4: Characters Without Dimension
**Symptoms:** Characters serve plot rather than driving it
**Interventions:** character-arc, underdog-unit, positional-revelation

### State 4.5: Plot Without Pacing
**Symptoms:** Scenes work individually but don't accumulate
**Interventions:** scene-sequencing

### State 5: Plot Without Purpose
**Symptoms:** Events happen but don't accumulate meaning
**Interventions:** moral-parallax, key-moments

### State 5.5: Dialogue Feels Flat
**Symptoms:** Characters sound alike, conversations lifeless
**Interventions:** dialogue

### State 5.75: Ending Doesn't Land
**Symptoms:** Story builds well but resolution disappoints
**Interventions:** endings

### State 5.85: Draft Not Progressing
**Symptoms:** Planning done but draft isn't happening
**Interventions:** drafting

### State 5.9: Prose Feels Flat
**Symptoms:** Story works but sentences are functional not memorable
**Interventions:** prose-style

### State 6: Draft Complete, Needs Revision
**Symptoms:** Draft exists but revision feels overwhelming
**Interventions:** revision

### State 7: Ready for Evaluation
**Symptoms:** Story exists but quality uncertain
**Interventions:** sensitivity-check, story-analysis

## Decision Tree

```
Is there anything on the page?
├── NO → story-idea-generator
└── YES → What's the problem?
    ├── Feels generic → cliche-transcendence
    ├── World feels thin → worldbuilding
    ├── Non-humans feel fake → conlang
    ├── Characters flat → character-arc
    ├── Pacing off → scene-sequencing
    ├── Dialogue wooden → dialogue
    ├── Ending weak → endings
    ├── Meaning unclear → moral-parallax
    ├── Draft not progressing → drafting
    ├── Prose flat → prose-style
    └── Draft needs revision → revision
```

## Diagnostic Process

1. **Listen for symptoms** - What are they describing as the problem?
2. **Ask clarifying questions** - Get specific about where they're stuck
3. **Identify the state** - Match symptoms to state list
4. **Name the diagnosis** - Explain what you're seeing
5. **Recommend intervention** - Point to specific skill
6. **Offer next steps** - What should they try first?

## Available Scripts

### entropy.ts
Injects creative randomness from curated lists.

```bash
deno run --allow-read scripts/entropy.ts lies
deno run --allow-read scripts/entropy.ts disasters --count 3
deno run --allow-read scripts/entropy.ts --combo
```

**Lists:** lies, ghosts, disasters, dilemmas, professions, locations, collisions, openings

### functions.ts
Generates characters from abstract story functions.

```bash
deno run --allow-read scripts/functions.ts
deno run --allow-read scripts/functions.ts --setting scifi
deno run --allow-read scripts/functions.ts healer --setting fantasy
```

**Functions:** healer, enforcer, keeper_of_secrets, maker, trader, guide, entertainer, death_worker, transgressor

## Anti-Patterns

### Prescribing Instead of Diagnosing
**Fix:** Always ask clarifying questions before diagnosing.

### Framework Overload
**Fix:** Recommend one intervention. Expand after reassessment.

### Ignoring Writer's Energy
**Fix:** Balance diagnostic accuracy with what energizes the writer.

### Treating Structure as Story
**Fix:** Keep asking "Does this feel right?" alongside structural diagnosis.

## Related Skills

Routes to all fiction skills based on diagnosed state.

© jwynia · MIT · jwynia/agent-skills

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

Всё по теме «Тексты и документация» →
story-init danjdewhurst Создаёт файловую структуру литературного проекта в Markdown: библию истории, реестры персонажей, трекер глав и таймлайн. CX Codex +1 773установок story-memory haowjy Скилл для ИИ-кодинга и письма: хранит канон, факты и контекст между главами. Пригодится, когда проект растёт и агент теряет детали. CX Codex +1 527установок fiction-workshop rhavekost Скилл ведёт рукопись в три этапа: Story Bible, работа над главами и проверка на свежем читателе. Для романов и сборников рассказов. CX Codex +1 2 100установок story-maintenance danjdewhurst Скилл запускает CLI для проверки ссылок, переиндексации реестров и поиска сюжетных несостыковок в Markdown-проектах. Помогает следить за структурой книги без ручной правки таблиц. CX Codex +1 694установок story-planning haowjy Помогает спланировать структуру сюжета, арки персонажей и сцены перед написанием текста. Переключает агента в режим подготовки и архитектуры истории. CX Codex +1 664установок sepia-hemingway Nanako0129 Скилл для написания и правки художественной прозы с голосом Хемингуэя. Работает только вместе с плагином Sepia. CX Codex +1 754установок

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

story-analysis Диагностика готового текста: скилл проходит по рассказу или главе романа и показывает, где провисает конфликт, персонаж или концовка. Пригодится после черновика. CX Codex +1 684установок joke-engineering Разбирает шутки, которые не срабатывают, и подсказывает, что в них поправить. Пригодится, когда панчлайн не заходит или текст звучит вымученно. CX Codex +1 674установок story-idea-generator Скилл помогает придумывать концепции историй, отталкиваясь от эмоции читателя, а не от декораций. Пригодится на старте проекта и когда замысел провисает. CX Codex +1 664установок system-design Разбирает проблемы проектирования и помогает соло-разработчику перейти от требований к архитектуре, компонентам и интерфейсам. CX Codex +1 647установок character-arc Помогает продумать внутренний путь героя и найти, почему перемена в финале не убеждает. CX Codex +1 614установок interactive-fiction Разбирает проблемы ветвящегося нарратива: выборы без последствий, неразрешимое ветвление, конфликт свободы игрока и авторской истории. CX Codex +1 558установок prose-style Разбирает проблемы на уровне предложений: монотонность, плоские фразы, лишние эпитеты, скачки голоса. Полезен, когда структура уже готова. CX Codex +1 553установок pptx-generator Собирает презентации PowerPoint из шаблона с подстановкой текста или с нуля по JSON-описанию. Пригодится, когда отчёт или питч-дек нужно собрать кодом, а не руками в PowerPoint. CX Codex +1 541установок

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

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