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

blind-spot-detective — скилл для Claude Code: что делает

Разбирает черновик нон-фикшна и показывает, чего в нём не хватает: слепые зоны подхода и пробелы, которые можно закрыть.

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

Что делает blind-spot-detective

Скилл работает как диагностика перед финальной вычиткой. Он гоняет текст по четырём наборам вопросов: когнитивные искажения (подтверждение своей точки зрения, проклятие знания, слепота к собственным предубеждениям), сократический опрос, чек-лист содержания и анализ пропущенных элементов. Отдельно разводит два типа дыр: слепые зоны — ограничения самого метода или взгляда автора, и пустые зоны — то, что закрывается внутри уже выбранного подхода. От этого зависит, менять ли угол зрения или просто дописать раздел.

Внутри есть таблицы по жанрам. Для технического текста это проклятие знания и пропущенный понятийный фундамент, для бизнес-текста — неучтённый контекст читателя и сложности внедрения, для советов — ошибка выжившего. Ещё приёмы: тест стороннего читателя, аудит структуры по цепочке «тезис — доказательства — возражения» и таблица действий под каждый тип пробела.

Запускать его имеет смысл на готовом черновике, а не на пустой странице: анализировать нечего, пока текста нет. И следите за ловушкой перфекционизма — если гонять проверку по кругу, работа никогда не закончится. Автор советует заранее задать порог: править то, что подрывает аргумент, а не каждую возможную ветку. Скилл лежит в репозитории jwynia/agent-skills под лицензией MIT.

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

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

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

  • прогони мой черновик через blind-spot-detective и покажи слепые зоны
  • какие возражения я не разобрал в этом тексте?
  • проверь статью на проклятие знания: что я объяснил недостаточно

Как установить blind-spot-detective

1Через Skills CLI (Vercel)

npx skills add jwynia/agent-skills --skill blind-spot-detective -a claude-code

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

~/.claude/skills/blind-spot-detective/SKILL.md

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

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

Вопросы о blind-spot-detective

Как установить blind-spot-detective в Claude?

Выполните npx skills add jwynia/agent-skills --skill blind-spot-detective -a claude-code. После этого файл скилла окажется в ~/.claude/skills/blind-spot-detective/SKILL.md.

Что делает blind-spot-detective?

Ищет в нон-фикшн-тексте пропущенное: непроверенные допущения, неразобранные контраргументы, отсутствующие перспективы и логические разрывы. На выходе — список пробелов с указанием, что с каждым делать.

Чем слепые зоны отличаются от пустых зон?

Слепые зоны — ограничения самого подхода или теории, их либо меняют, либо честно оговаривают. Пустые зоны закрываются внутри текущего подхода: добавить источник, пример или переход.

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

SKILL.md · MIT
---
name: blind-spot-detective
description: Systematically identify what's missing in non-fiction writing—both blind spots (inherent limitations) and blank spots (gaps that could be addressed). Use before finalizing non-fiction or when feedback feels incomplete.
license: MIT
metadata:
  author: jwynia
  version: "1.0"
  type: diagnostic
  mode: evaluative
  domain: writing
---

# Blind Spot Detective

## Purpose

Systematically identify what's missing in non-fiction writing—both blind spots (inherent limitations of your approach) and blank spots (gaps that could be addressed). Provides frameworks for finding omissions, testing assumptions, and ensuring comprehensive coverage.

## Core Principle

**What you can't see matters more than what you can.** Identifying what's missing is harder than recognizing what's included. Systematic interrogation reveals gaps that casual review misses.

---

## Blind Spots vs. Blank Spots

| Type | Definition | Solution |
|------|------------|----------|
| **Blind Spots** | Limitations inherent to your methodology, theory, or perspective | Adjust your approach or acknowledge limitations |
| **Blank Spots** | Gaps that could be addressed within your current approach | Expand coverage within existing framework |

**Key insight:** Understanding which type of gap you're dealing with determines whether to change your approach or simply expand it.

---

## Framework 1: Cognitive Bias Check

### Confirmation Bias
Processing information that confirms existing beliefs while ignoring contradictions.

**Self-check:**
- Have I primarily sought sources supporting my views?
- Have I given fair consideration to counter-evidence?
- Am I dismissing perspectives without adequate examination?

### Curse of Knowledge
Assuming readers share your specialized knowledge.

**Self-check:**
- Have I defined specialized terminology?
- Am I assuming background knowledge readers might lack?
- Would someone new to this topic understand?

### Bias Blind Spot
Recognizing biases in others but not yourself.

**Self-check:**
- Have I critically examined my own assumptions?
- Am I applying the same standards to opposing views?
- Have I invited critique from different perspectives?

---

## Framework 2: Socratic Questioning

| Question Type | Purpose | Examples |
|---------------|---------|----------|
| **Clarification** | Explore complex ideas | What exactly do I mean? How does this relate to my main argument? |
| **Assumption-Probing** | Uncover hidden assumptions | What am I taking for granted? What unstated beliefs underlie this? |
| **Evidence & Reasoning** | Evaluate support quality | What evidence supports this? Is it sufficient? Does my conclusion follow? |
| **Alternative Viewpoints** | Challenge default framework | How would a different discipline view this? What would critics say? |

---

## Framework 3: Content Checklist

### Thesis Clarity
- Is the main idea clearly stated early?
- Does each section contribute to the main thesis?
- Have I articulated why this topic matters?
- Would a reader easily identify my central argument?

### Structure & Flow
- Does section order make logical sense?
- Are transitions smooth and coherent?
- Is there clear progression of ideas?
- Have I provided signposts for the reader?

### Credibility & Evidence
- Are all claims supported by credible evidence?
- Have I addressed significant counter-arguments?
- Are sources diverse and representative?
- Have I been transparent about methodological limitations?

### Audience Perspective
- Have I considered audience knowledge vs. my knowledge?
- Are technical terms adequately explained?
- Would someone outside my field understand?
- Have I considered diverse reader backgrounds?

---

## Framework 4: Missing Elements Analysis

### Missing Perspectives
- **Stakeholder gaps:** Whose voice is absent?
- **Cultural gaps:** What cultural perspectives are missing?
- **Historical gaps:** What historical context is omitted?
- **Disciplinary gaps:** What other fields would add insight?

### Missing Content Types
- **Examples:** Are abstract concepts grounded in concrete cases?
- **Counter-examples:** Have I addressed what doesn't fit my thesis?
- **Transitions:** Do ideas flow or jump?
- **Implications:** Have I addressed "so what?"

### Missing Logic
- **Unstated premises:** What assumptions bridge my arguments?
- **Alternative explanations:** What else could explain my evidence?
- **Edge cases:** What situations challenge my generalizations?
- **Causal gaps:** Am I conflating correlation with causation?

---

## Detection Techniques

### Outsider Test
Read as if you:
- Disagree with your thesis
- Know nothing about the topic
- Come from a different culture
- Work in a different field

### Gap-Finding Questions
- What would a hostile reviewer point out?
- What questions would a curious reader ask?
- What would someone from [different field] notice missing?
- What did I almost include but cut?

### Structural Audit
1. List each section's main claim
2. List evidence supporting each claim
3. List possible objections to each claim
4. Identify which objections you addressed
5. Note unaddressed objections

---

## Common Blind Spots by Genre

### Academic Writing
- Over-reliance on literature from one tradition
- Ignoring practical implications
- Assuming disciplinary jargon is universal
- Missing interdisciplinary connections

### Business Writing
- Assuming reader shares organizational context
- Overlooking implementation challenges
- Missing stakeholder perspectives
- Ignoring historical precedents

### Self-Help/Advice
- Survivorship bias (only successful examples)
- Ignoring structural barriers
- Assuming universal applicability
- Missing edge cases and exceptions

### Technical Writing
- Curse of knowledge (expert blindness)
- Missing conceptual foundation
- Skipping "obvious" steps
- Ignoring non-technical context

---

## Remediation Actions

| Gap Type | Action |
|----------|--------|
| Missing evidence | Add sources, examples, or data |
| Missing perspective | Seek input from that group or acknowledge gap |
| Missing logic | Add explicit reasoning or transitions |
| Missing context | Add background or definitions |
| Inherent limitation | Acknowledge in scope statement |

---

## Anti-Patterns

### 1. The Perfection Paralysis
**Pattern:** Using blind spot detection to delay finishing. Every gap found leads to more analysis. Nothing is ever complete enough.
**Why it fails:** Writing is never perfect. Blind spot detection is for identifying significant omissions, not achieving impossible completeness.
**Fix:** Set a threshold. "I will address gaps that fundamentally undermine my argument, not every possible expansion." Time-box the detection process.

### 2. The Detective Without a Case
**Pattern:** Running blind spot analysis before having a draft. Looking for gaps in something that doesn't exist yet.
**Why it fails:** Blind spot detection works on existing writing. You need something to analyze. Pre-draft gap anxiety prevents ever starting.
**Fix:** Write first, detect second. Get a complete draft, then identify what's missing. Gaps are easier to see in concrete text than abstract plans.

### 3. The Scope Creep Trap
**Pattern:** Treating every identified gap as something to address. Expanding scope until the piece becomes unmanageable.
**Why it fails:** Not every gap needs filling. Some gaps are appropriate for scope. Trying to address everything produces bloated, unfocused writing.
**Fix:** Distinguish blind spots (acknowledge limitation) from blank spots (expand coverage). For each gap, ask: "Is filling this essential to my thesis?"

### 4. The Outside Expertise Dependency
**Pattern:** Believing you need outside experts to identify blind spots. Waiting for external validation instead of systematic self-review.
**Why it fails:** While outside perspectives help, you can identify many blind spots yourself with systematic frameworks. Dependency creates bottlenecks.
**Fix:** Use the frameworks first. Get external review for validation, not discovery. Most obvious gaps can be found with structured self-interrogation.

### 5. The Gap List Without Priorities
**Pattern:** Producing exhaustive lists of missing elements without prioritizing which matter most.
**Why it fails:** A 50-item gap list is paralyzing. Not all gaps are equal. Without priority, writers either give up or address gaps randomly.
**Fix:** Categorize by severity: critical (undermines thesis), significant (weakens argument), minor (would enhance). Address critical first.

## Integration Points

**Inbound:**
- Before finalizing non-fiction writing
- During revision process
- When feedback feels incomplete

**Outbound:**
- To revision and editing
- To additional research
- To scope clarification

**Complementary:**
- `non-fiction-revision`: For implementing fixes
- `summarization`: For testing thesis clarity
- `research`: For filling evidence gaps

© jwynia · MIT · jwynia/agent-skills

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

Всё по теме «Тексты и документация» →
fiction-workshop rhavekost Скилл ведёт рукопись в три этапа: Story Bible, работа над главами и проверка на свежем читателе. Для романов и сборников рассказов. CX Codex +1 2 100установок humanizer Aboudjem Находит 55 признаков машинного письма и переписывает текст под выбранный голос — от разговорного до сухого технического. Пригодится перед публикацией поста, README или письма. CX Codex +1 1 100установок better-writing forjd Переписывает, черновики и вычитывает прозу: письма, отчёты, документацию, тексты интерфейса. Полезен, когда текст звучит шаблонно или по-чатботовски. CX Codex +1 514установок avoid-ai-writing Conor Bronsdon Скилл находит характерные следы машинной генерации в тексте и переписывает формулировки. Помогает убрать речевые штампы перед публикацией документации или постов. CX Codex +1 4 600установок sepia Nanako0129 Скилл убирает признаки машинного текста в художественной прозе и рабочих документах. Он помогает переписать чейнджлоги, тикеты и статьи живым языком. CX Codex +1 1 400установок clarity addyosmani Помогает редактировать и рецензировать статьи или документацию без выдуманных фактов и шаблонных нейросетевых фраз. CX Codex +1 1 200установок

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

dependency-scan Скилл проверяет зависимости проекта на известные уязвимости и предлагает обновления до пропатченных версий. Пригодится перед релизом или когда нужно быстро оценить чужой репозиторий. CX Codex +1 355установок config-scan Скилл проверяет конфигурационные файлы, Docker, Kubernetes и Terraform на небезопасные настройки. Пригодится перед выкаткой в прод. CX Codex +1 337установок agile-coordinator Раздаёт задачи из бэклога воркерам, следит за прогрессом, сводит ветки и проверяет сборку. Нужен, когда готовых задач много и делать их вручную долго. CX Codex +1 335установок npm-package Скилл ведёт агента через создание npm-библиотеки на Bun: скаффолдинг, строгий TypeScript, тесты, сборка и публикация. CX Codex +1 331установок non-fiction-revision Разбирает рукопись нон-фикшн по уровням и подсказывает, что править. Пригодится, когда тезис размыт, аргументы провисают или читатели путаются. CX Codex +1 326установок gitea-coordinator Раздаёт готовые задачи из бэклога Gitea воркер-агентам, следит за прогрессом и сам сводит пул-реквесты в main. Нужен, когда задач много и хочется прогнать их пачкой. CX Codex +1 316установок web-search-brave Скилл ищет в интернете через Brave Search API: свежесть, страна, язык, дополнительные сниппеты. Нужен ключ BRAVE_API_KEY и Deno. CX Codex +1 312установок github-agile Диагностирует проблемы agile-процесса на GitHub и подсказывает, как вести feature-ветки, issues и пул-реквесты. CX Codex +1 311установок

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

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