Worked example: the legibility check, or Claude asks instead of guessing

← All guides·Worked example

When Claude cannot read a word, it should say so and ask. The legibility-review skill makes it do that, one question at a time, before anything goes into the transcript. This page shows the exchange on a made-up bundle.

This is for the documents that PDF intake could not settle: handwriting, faint stamps, signatures, bad photocopies. It is the answer to the referral form with a second applicant written in the margin, the kind of detail that vanishes from every later document if nobody reads it.

What the skill does

The legibility-review skill produces a full, reliable transcript of one document or a whole bundle. The difference from ordinary OCR is that doubtful readings are resolved before they are written down, not after. It works in four steps.

Step 1 — Read everything, and build an index

Claude pulls the text out of every file in the bundle first (typed PDFs directly, scans through PDF intake). For a bundle it builds a cross-reference index: every name, date, case number and amount, and where each one appears. That index is what lets a clean copy in one document settle a doubtful reading in another.

Step 2 — Find the doubtful spots, and settle what it can

Claude goes through each document and lists every spot it is not sure of. Many are settled without troubling you:

  • a smudged case number on a stamped cover page, typed clearly in the heading of the founding affidavit;
  • a faint signature, where the same person’s typed name is in the signature block of three other letters;
  • an unclear handwritten amount that is itemised in a typed schedule elsewhere.

Each of these is logged, not hidden. And if the two copies disagree, Claude does not pick one. A disagreement between two sources is a finding, and it comes to you.

Step 3 — Ask, one question at a time

A made-up referral form. Claude shows the spot, gives its best reading and how sure it is, and waits.
A made-up referral form. Claude shows the spot, gives its best reading and how sure it is, and waits.

What is left comes to you, one question at a time. Each question gives the page and place, Claude’s best reading, how confident it is, why it matters, and a cropped picture of the spot so that you are looking at what Claude is looking at. Nothing goes into the transcript until you answer. Every question and answer is logged.

The rules the skill follows:

  • no silent guessing;
  • no silent correction of typing errors: they are copied as they are and marked [sic];
  • no made-up text: an unreadable passage is marked [unreadable];
  • where it is still unsure, it says so, and writes [unclear: best guess “X”].

Step 4 — The transcript and the legibility note

The transcript keeps the original’s paragraph numbers and page markers, and marks handwriting as [handwritten]. At the end, a short note for each document says what you confirmed, what was settled from other documents, what is still unclear, and a reliability rating (high, medium or low) with one sentence of reasoning. The rating is meant to be honest, not “high” by default.

A prompt you can copy

Use it in Claude Cowork with the matter folder connected. Replace the words in square brackets.

Run a legibility review of [folder or file]. First extract the text from every file and build a cross-reference index of names, dates, case numbers and amounts. Then, document by document, list every reading you are not sure of. Settle what you can from a clearer copy elsewhere in the bundle and log it; if two copies disagree, ask me. Ask me the rest one at a time: page, place, your best reading, your confidence, why it matters, and a crop of the spot. Do not write any doubtful text into the transcript until I answer. Mark typos [sic] and unreadable passages [unreadable]. Finish with a legibility note per document with a reliability rating.

Limits

  • It is slow on a bad bundle. One question at a time is the point, but thirty questions is thirty questions. Answer the ones about names, dates, numbers and amounts first.
  • It only sees what it is given. A page missing from the scan is not a legibility problem; check the page count against the index.
  • It depends on you. A careless answer goes straight into the transcript. For a single handwritten form, a guided walk through the form section by section works better than a queue of questions.

Building it yourself

The skill is a written brief of the kind built in Guide 4, with the four steps above as its instructions and the rules above stated as rules. It uses the PDF intake routine for scanned pages.