Immutable. This exact content is served forever at /api/v1/blob/0fea658b17c1bc51.
---
name: read
description: Read PDF page by page with structured output — key arguments, terms glossary, thesis connections. Use when reading academic papers, books, or articles.
allowed-tools: Read, Glob, Grep
---
# /read — Academic PDF Reading Skill
## Core Principle
**Display first, restrain expansion.** Show the page content, provide a terms glossary, give a brief summary and thesis connections. Do not auto-expand, auto-search, or auto-record unless the user explicitly asks. The reader controls the pace and direction.
## Trigger Words
This skill activates on: `read`, `next page`, `continue`, `skip to p.N`, `read p.N`, `/read`.
## PDF Limits (advisory in this release)
- **Maximum 15 pages per invocation.**
- **Maximum 90 pages per conversation** — a context-health budget. This is
currently an advisory rule the model follows imperfectly, not an enforced
counter; do not present it as tracked. (The dsh guard that enforces both
budgets deterministically ships in P1 of the dsh app.)
- When a request clearly approaches the budget, say so and suggest starting a
new conversation.
## Workflow
1. **Identify the PDF.** If the user provides a path, use it directly. If the user names an author or title, search the project's `literature/` directory using Glob to locate the file.
2. **Read the specified page(s)** using the Read tool with the `pages` parameter. Default to the next unread page if the user says "next page" or "continue".
3. **Display structured output** following the format below.
4. **Wait for user instruction.** Do not proceed to the next page, take notes, or search for related material unless explicitly asked.
## Output Format
For each page read, produce the following:
```
## p.{N} -- {Topic Summary}
### Content
**{Paragraph topic}**
> "{direct quote}" (p.{N})
- {key point}
- {key point}
**{Next paragraph topic}**
> "{direct quote}" (p.{N})
- {key point}
### Key Terms
| Term | Translation | Context |
|------|-------------|---------|
| {term} | {if non-English, provide translation} | {how it is used on this page} |
### Summary
{3-5 sentence summary of the page content. Focus on the argument structure and evidence presented.}
### Connections
- **Thesis link**: {one sentence connecting to the user's research}
- **Previous page**: {one sentence on continuity with previous page, or "First page" if N=1}
- **Open question**: {if any unresolved point or tension is raised}
---
Next page? Take notes? Expand a connection?
```
## Ceremony Control
Emit the `### Key Terms` table only when the page introduces genuinely new
terms, and `### Connections` only when there is a real thesis link or open
question — skip empty sections rather than filling them for form's sake. For
a page range, one Key Terms table and one Connections block for the range is
usually right.
## Handling Multiple Pages
When reading a range (e.g., "read p.10-15"):
- Produce the structured output for each page individually.
- At the end, add a range summary section:
```
## Pages {start}--{end} Summary
{5-8 sentence summary of the range as a whole}
```
## Constraints
1. **Never auto-record notes.** The user must explicitly say "take notes", "record this", or invoke `/note`.
2. **Never auto-search** for related literature, web sources, or definitions unless the user asks.
3. **Never launch agents** or parallel tasks.
4. **All extensions require explicit user request** -- expanding a connection, comparing with another source, verifying a claim.
5. **Literature directory** is determined from project configuration. Do not hardcode paths.
6. **Keep connections to 1-2 sentences max.** Do not elaborate. The user will ask if they want more.
7. **Preserve original language** for key terms. If the source is in a non-English language, show the original term alongside the translation.
8. **Quote accurately.** Use the exact text from the PDF. If a quote spans pages, note both page numbers.