---
name: Collapse Detection
slug: collapse-detection
category: Writing
description: Collapse Detection identifies documentation type-mixing patterns such as tutorial creep, how-to bloat, and reference narrative. Use it to flag docs that combine multiple user intents and to guide splitting or remediation.
github: "https://github.com/nWave-ai/nWave/tree/main/nWave/skills/nw-collapse-detection"
language: Python
stars: 598
forks: 61
install: "npx degit https://github.com/nWave-ai/nWave/tree/main/nWave/skills/nw-collapse-detection ~/.claude/skills/nw-collapse-detection"
installs_to: ~/.claude/skills/nw-collapse-detection
source_path: nWave/skills/nw-collapse-detection/SKILL.md
collection_size: 25
category_size: 1012
collection_url: "https://dirskills.com/collections/nWave-ai/nWave"
added: 2026-08-25T05:13:09.969Z
last_synced: 2026-08-25T05:13:09.969Z
canonical_url: "https://dirskills.com/skills/collapse-detection"
---

# Collapse Detection

Collapse Detection identifies documentation type-mixing patterns such as tutorial creep, how-to bloat, and reference narrative. Use it to flag docs that combine multiple user intents and to guide splitting or remediation.

**Install:**

```bash
npx degit https://github.com/nWave-ai/nWave/tree/main/nWave/skills/nw-collapse-detection ~/.claude/skills/nw-collapse-detection
```

## README

# Collapse Detection

Documentation collapse = types merge inappropriately, serving no audience well.

## Anti-Patterns

### Tutorial Creep
Description: Tutorial explains "why" extensively | Detection: explanation >20% | Fix: extract to separate doc, link back

### How-to Bloat
Description: How-to teaches basics first | Detection: teaching fundamentals before steps | Fix: link to tutorial, assume baseline

### Reference Narrative
Description: Reference includes conversational prose | Detection: prose paragraphs in entries | Fix: move to explanation doc, keep factual

### Explanation Task Drift
Description: Explanation ends with "do this" steps | Detection: step-by-step in explanation | Fix: move steps to how-to, link

### Hybrid Horror
Description: Single doc tries all four types | Detection: 3+ quadrants in one doc | Fix: split with clear boundaries

## Detection Rules

Flag collapse when:
- >20% content from adjacent quadrant | Two user needs served simultaneously | Ambiguous user journey stage
- "Why" in tutorials | Task steps in explanations | Teaching in how-tos | Narrative in references

## Bad Examples for Calibration

### Tutorial with Task Focus
```markdown
# Getting Started
If you need to deploy to production, follow these steps...
```
**Problem**: Assumes user knows what "deploy to production" means. A tutorial should assume nothing.

### How-to Teaching Basics
```markdown
# How to Configure Authentication
First, let's understand what authentication is. Authentication is...
```
**Problem**: Should assume user knows what authentication is. Link to a tutorial instead.

### Reference with Opinions
```markdown
## login(username, password)
This is probably the most important function you'll use...
```
**Problem**: Reference should be factual, not opinionated. Remove "probably the most important" editorializing.

### Explanation with Steps
```markdown
# Why We Use Microservices
... therefore, you should: 1. Create a service, 2. Deploy it...
```
**Problem**: Steps belong in a how-to guide. The explanation should end with reasoning and link to the how-to for action.