DocumentsEveryday skill

PDF to Summary

Turn a long PDF or report into a layered summary: three bullets, then one page, then full notes with page references.

What it does

A 40-page contract before a renewal deadline. A report someone forwarded with "thoughts?". A deck you have to discuss on Thursday. Too long to read properly, too important to skim and hope.

With this skill active, the assistant settles one question first: what you need the document for. Deciding something keeps very different parts than reviewing a draft or learning a subject. It then reads the structure before the words, writes the sentence the whole thing exists to deliver, and builds the summary downwards.

What lands in your hands is one document at three depths: three bullets for the person who reads only three lines, a one-page version organised by the document's own sections, and full notes where every point cites its page. Under that sits a watch list of dates, costs and obligations, plus an honest note on what the document leaves unclear.

You end up with one document at three depths, plus a watch list of dates, costs and obligations that cites every page.

When to reach for it

Good for contracts and renewals, reports being used to argue for something, policy documents, research papers, and any deck you need to have an opinion about by tomorrow.

Not worth it for a short document you can read in five minutes, or when you need someone to tell you what a contract means for you specifically. A summary is not legal advice, and it will say so.

What's inside

pdf-to-summary/
├── SKILL.md
└── references/
    ├── examples.md
    └── document-types.md
SKILL.md
---
name: pdf-to-summary
description: Turns a long PDF, report, contract or slide deck into a layered summary (three bullets, then one page, then full notes where every point cites its page) plus a watch list of dates, costs and obligations. Use when a document is too long to read in full but too important to skim blindly.
---

# PDF to Summary

You are the person who has already read the whole document, so the user does not have to be. Your job is to make one document readable at three depths without the three depths ever disagreeing with each other.

## Workflow

1. **Ask what the summary is for.** Decision, review, or general understanding. This changes what you keep far more than the document's subject does.
2. **Read the shape before the words.** Headings, section lengths, where the argument turns, where the numbers live.
3. **Write the core message in one sentence.** What the document is actually saying or asking for.
4. **Build the three layers top down.** Three bullets, then one page, then full notes with a page reference on every point.
5. **Sweep for watch items.** Dates, money, obligations, and anything that happens automatically.
6. **Name the gaps.** What the document leaves unclear, and what you could not read.

Copy this checklist into your working notes and tick it as you go:

```text
Document summary checklist
[ ] Purpose known: decide / review / understand, and who reads the summary
[ ] Structure mapped before any summarising
[ ] Core message written in one sentence
[ ] Layer 1: three bullets
[ ] Layer 2: one page, organised by section
[ ] Layer 3: full notes, every point carries a page or section reference
[ ] Layers checked against each other - no contradictions
[ ] Watch items listed: dates, money, obligations, automatic events
[ ] Gaps listed: unclear, missing, or unreadable
[ ] Coverage stated: which pages were actually read
```

## Step 1: what the summary is for

Ask for the purpose in the same message as the document. One question, four parts: what you need this for, who reads the summary, which sections matter most, and whether this is the whole document or an extract.

| The user needs to | Keep hard | Let go |
|---|---|---|
| Decide something | Options, costs, deadlines, what happens if they do nothing | Background, methodology, history |
| Review or approve | Changes from the last version, risks, anything they would be signing up for | Sections that are unchanged boilerplate |
| Understand a subject | The argument, the evidence, the limits of the evidence | Commercial terms, process detail |

If the user does not answer, assume "understand", say that you assumed it, and offer to re-cut the summary for a decision if that is what they actually need.

## Step 2: read the shape before the words

Spend the first pass on structure only. You are looking for where the document keeps its real content, which is rarely where it announces it.

- Count the sections and note which ones are long. Length is where the effort went.
- Find the turn: the paragraph where the document stops describing and starts asking, recommending, or obliging.
- Find where numbers appear. Numbers concentrate in a few places; note the page.
- Note anything the document points at but does not include: an appendix, a schedule, a linked policy, a referenced study.

`references/document-types.md` lists where the real content hides in contracts, research reports, slide decks, policies and academic papers. Read it when the document type is one you have not summarised in this session.

## Step 3: the core message in one sentence

Before writing any layer, write the sentence the whole document exists to deliver:

- "This contract renews itself every 12 months unless we cancel 60 days out, and the price rises 7% each renewal."
- "The study found a small effect, and its own authors say the sample was too narrow to generalise."
- "The team is asking for two more engineers and a delayed launch date."

If you cannot write that sentence, the document may genuinely lack one. Say so in those words rather than manufacturing one.

## Step 4: the three layers

Write them in order. Each layer is a longer version of the same truth, never a different one.

**In 3 bullets.** For someone who reads only this. What it is, the one number or date that matters most, and the thing they have to do or decide. No sub-bullets, no page references, no hedging.

**In one page.** Organised by the document's own sections, in plain sentences, roughly 250 to 400 words. Follow the document's structure, not your own, so the reader can navigate back into it.

**Full notes.** Every substantive point, each ending with a reference like `[p. 14]` or `[Section 4.2]`. Group by section. This layer is for the person who will act on it and needs to check it.

Then read the three layers back to back. If the one-pager says the contract is annual and the notes say it is 18 months, the notes are usually right and the shorter layer needs fixing. Never ship layers that disagree.

## Step 5: watch items

A separate list, after the layers, because these are what people miss and later regret. Sweep for:

- **Dates:** deadlines, notice periods, expiry, review dates, anything with a clock on it.
- **Money:** totals, per-unit costs, increases, penalties, minimums, what is excluded.
- **Obligations:** what the reader's side must do, by when, and what happens if they do not.
- **Automatic events:** auto-renewal, automatic escalation, default settings that apply if nobody acts.
- **Limits:** liability caps, exclusions, conditions that void something.

Each watch item gets one line and a page reference. Say plainly if the sweep found nothing in a category rather than silently omitting it.

## Step 6: gaps and coverage

Close with two short lists:

- **Unclear or missing:** terms used but never defined, a promise with no date attached, a number with no basis, a referenced appendix that was not included.
- **Coverage:** which pages you actually read. If the user pasted 12 pages of a 40-page document, say that in the first line of the summary, not in a footnote.

## Citing pages when there are no page numbers

Pasted text and web-exported documents often have no page numbers. Cite anyway, using whatever anchor the reader can search for:

- Numbered sections or clauses: `[Section 4.2]`, `[Clause 11(b)]`.
- Headings: `[under "Termination"]`.
- Nothing else available: quote the first four words of the sentence, `["The Supplier shall provide..."]`.

A note the reader cannot verify is worth much less than one they can.

## Keep the document's claim separate from your read

Write what the document says. When you add your own inference, label it in the same sentence.

- Document says: "Uptime was 99.2% across the quarter [p. 8]."
- Your read: "Reads as a miss - the contract commits to 99.5% [p. 3], though the document never connects the two."

Never merge the two. A reader who cannot tell your inference from the source will either trust too much or trust nothing.

## Example

**Input:** a 9-page renewal quote and terms from a cloud storage vendor. Purpose: decide whether to renew. Reader: the office manager who will sign it.

**Core message:** "Renewing as offered costs 41% more than last year, and the new terms lock in for 24 months instead of 12."

**In 3 bullets**

- Renewal is 24 months at $1,410/month, up from $1,000/month on a 12-month term.
- The price rise is mostly a storage tier change, not a rate rise: the actual usage sits just above a tier boundary.
- To avoid it, either cancel by 30 April or ask to be moved back to a 12-month term before signing.

**In one page**

> Pricing and term (pp. 1-3). The quote covers 24 months from 1 June at $1,410 per month, billed annually in advance. The previous agreement was 12 months at $1,000 per month, billed monthly...

**Full notes (extract)**

- Monthly fee $1,410, annual prepayment, no monthly option offered [p. 1].
- Term is 24 months with no break clause [p. 2].
- Storage tier moves from 5TB to 10TB; current usage is 5.3TB [p. 4].
- Cancellation requires 30 days written notice before the current term ends, so by 30 April [p. 7].

**Watch items**

- 30 April cancellation deadline: after this the current term auto-renews [p. 7].
- Annual prepayment means the full $16,920 leaves in one payment [p. 1].
- Overage above 10TB is charged at $0.09/GB, uncapped [p. 5].

**Unclear or missing:** the quote references "Schedule B - Support Levels", which was not included [p. 6].

**Coverage:** all 9 pages of the quote. The linked master agreement was not provided.

Notice that the three bullets are enough to act on, the notes are enough to argue with, and every number can be found again.

## Rules

- Do not add information that is not in the document. If the user needs outside context, say what is missing and offer to look it up as a separate step.
- Never let a shorter layer contradict a longer one.
- Every point in the full notes carries a reference. No exceptions.
- Flag legal, financial, medical and safety items in the watch list. Never bury them inside a paragraph.
- Use the document's own terms, defined once, rather than substituting friendlier words that shift the meaning.
- Say what you could not read: scanned pages, cut-off tables, images with text in them.
- Summarising a contract is not legal advice, and summarising a diagnosis is not medical advice. Say so once, plainly, and keep going.

## Edge cases

- **Only part of the document was provided.** Summarise what you have and put the coverage line first, not last. Do not extrapolate the missing sections.
- **The document contradicts itself.** Report both versions with both page references and say which one governs if the document says so. Do not silently pick one.
- **The text is garbled or scanned badly.** Summarise the readable parts, list the pages that came through as noise, and ask for those pages again rather than guessing at the numbers.
- **Almost all of it is boilerplate.** Say so. Three bullets, a short watch list, and one line naming which clauses are non-standard is a better summary than a padded one.
- **The user wants the document to support a decision it does not support.** Give the honest read, in one sentence, before the layers.
- **Numbers appear only in charts or images.** Say which numbers came from a chart and that they are read off, not stated.
- **Several documents at once.** Summarise each separately first, then add a short section on where they disagree. Merging them straight away hides the disagreement, which is usually the interesting part.
- **The document is a slide deck.** The speaker carried half the meaning and is not in the file. Summarise what the slides claim and flag where a slide clearly needed narration.

## Files

- `references/examples.md` - three documents worked end to end: a vendor contract read for a renewal decision, an industry research report read for a team briefing, and an internal strategy deck read for what it avoids saying. Read one fully before your first summary to see how far the layers travel apart.
- `references/document-types.md` - where the real content hides by document type, and the watch items each type reliably produces. Read it when you are handed a type you have not summarised yet.

Install it

Claude Code (this project)

Unzip the download into .claude/skills/. The folder is already named right.

Claude Code (every project)

Unzip into ~/.claude/skills/ to use it everywhere.

claude.ai

Upload the zip under Settings, then Capabilities, then Skills (paid plans).

How to call it

Just describe the task. The description line inside the skill does the matching. Or call it directly:

/pdf-to-summary summarise this PDF for megive me the short version and the long version of this reportwhat am I actually agreeing to in this contractI need to review this document before a meeting tomorrowpull out the key dates and costs from this

Works beyond Claude

Skills use the open Agent Skills format. The exact same folder works in OpenAI Codex, Gemini CLI, Cursor, GitHub Copilot and other tools that read the format.

Using a plain chat app? Paste SKILL.md into ChatGPT or Gemini as instructions. You lose auto-triggering, but the method still works.

agentskills.io

Related skills