# Deep Reading

> Reads an entire file and produces a structured content map showing sections, entities, claims, and gaps. Use when needing to understand a file before editing, checking conversion completeness, or when user says "what is in this file", "content map", "deep read", "read the whole thing", or "check completeness". Does NOT modify files — read-only analysis only.

- Skill: `alainator/deep-reading` (Agent Skill)
- Install (CLI): `npx skillmds@latest add alainator/deep-reading`
- Raw SKILL.md: https://api.skillmd.com/api/skills/alainator/deep-reading/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: alainator (https://skillmd.com/u/alainator)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/alainator/deep-reading

---


# Deep Reading

Read a file completely and produce a structured content map.

## Process

1. Read the ENTIRE file (no cutoff)
2. Produce content map: sections, named entities, standalone content
3. Gap analysis: compare against repo for missing files/entries

## Output

```
## Content Map: [filename]
### Sections
1. [Heading] (lines X-Y) — [one-line summary]
### Named Entities
- Characters: [list]
- Locations: [list]
- Concepts: [list]
### Gaps
[Missing entries, truncated content, orphaned sections]
```

## Out of Scope

Does NOT modify files. Read-only analysis.
Does NOT audit for contradictions (use /auditing-physics).