quiz

Readwise Access

mcp__readwise__reader_list_documents

readwise

readwise list

readwise read <id>

readwise search <query>

Setup

1. Check for persona file. Read

   reader_persona.md

   in the current working directory if it exists. Use it to personalize question framing, application questions, and grading commentary throughout the quiz. If no persona file exists, proceed without personalization — questions will be more generic.
2. Welcome the user. Open with a brief, friendly introduction:

   Quiz · Readwise Reader

   I'll find something you've recently read and quiz you on it — one question at a time, graded like a smart colleague who also read the piece.

   (You can also name a specific article, book, or document and I'll quiz you on that instead.)

3. Find a document to quiz on. The user may provide a document in one of these ways:
   If they give a specific document (title, URL, or ID) — use

   mcp__readwise__reader_search_documents

   or

   mcp__readwise__reader_list_documents

   with

   id

   to find it.
   If they say "quiz me" with no specific document — find recently read material:
   • Make ONE call:

     mcp__readwise__reader_list_documents

     with

     location="archive"

     ,

     limit=10

     ,

     response_fields=["title", "author", "category", "word_count", "summary", "url", "saved_at"]

     . Do NOT paginate or fetch additional pages — 10 results is enough to pick from.
   • If the first 10 archive results are all very short tweets/RSS items with no substance, make ONE more call to "later" with

     reading_progress

     and look for documents with progress > 50%. That's it — two calls maximum.
   • Present 3-5 candidates as a table, then ask the user to pick:

   #	Title	Author	Length
   1	...	...	...

   Or if there's a clear best pick, confirm: "Want me to quiz you on [title]?"
4. Fetch the full document. Use

   mcp__readwise__reader_get_document_details

   with the document's ID to get the full content. Also fetch any highlights with

   mcp__readwise__reader_get_document_highlights

   — these tell you what the user found important.
5. Read the document. Understand its core arguments, key claims, structure, and nuances. Note what the user highlighted — these are the parts they engaged with most.

Quiz Flow

Opening

Quiz: [Title] by [Author] [Category] · [word count or read time]

[1-2 sentence description of what the piece argues/covers]

I'll ask [3-5] questions. Ready?

Question Types

• "What's the core argument?" — Tests if they got the main point
• "How would you apply this to [their domain]?" — Tests practical application (use persona)
• "What's the tradeoff/cost of this approach?" — Tests critical thinking
• "What did the author miss or hand-wave?" — Tests deep reading
• "If you had to bet on [prediction], would you? Why?" — Tests synthesis
• "How does this connect to [another thing they've read]?" — Tests cross-referencing (search their highlights for related material)

Personalization

• Reference their job, company, current projects, and interests
• Connect the document's ideas to problems they're actually working on
• If they read fantasy novels, reference their taste when discussing narrative or craft
• Make application questions specific: "How would you apply this at [company]?" not "How would you apply this?"

Question Count

• Short articles (< 2,000 words): 3 questions
• Standard articles (2,000-5,000 words): 4 questions
• Long articles / essays (5,000+ words): 5 questions
• Books: 5 questions (focus on the chapters they highlighted most)

Grading

1. State the grade clearly: Grade: B+
2. Acknowledge what they got right — be specific
3. Fill in what they missed or could go deeper on
4. Quote the document if relevant to reinforce the point
5. Transition to next question

Grading Scale

• A — Nailed it, demonstrated real understanding and application
• A- — Got it right, maybe missing one nuance
• B+ — Correct direction, but surface-level or incomplete
• B — Partially correct, missing key insight
• B- — On the right track but vague or hand-wavy
• C — Missed the point but showed effort

Grading Style

Final Score

1. Overall score (e.g., "Final Score: B+")
2. One-line summary of what they understood well
3. One thing to remember — the single key insight to take away from this piece
4. Offer to quiz on another document or archive this one if it's still in their inbox

Tone

• Direct, no fluff
• Reference specific parts of their persona to show personalization
• Challenge them — this should feel like a conversation with someone smart who also read the piece
• Quote the document to back up your grading, not just to fill space