quiz — Claude Code skill: reading quizzes and installation
This skill quizzes you on documents from Readwise Reader, one question at a time, then grades your answers. Use it to check what you remember after reading.
npx skills add readwiseio/readwise-skills --skill quiz -a claude-codeWhat quiz does
The skill can pick a recently read item or use a document you identify by title, URL, or ID. It retrieves the full text and your highlights, then asks questions individually and grades each reply. At the end, it gives an overall score and one takeaway.
Questions can test the document’s main claim, how you would apply its ideas, or what its argument leaves out. A reader_persona.md file in the current directory lets the skill tailor questions to your work and interests; without one, the questions stay general. It needs access to Readwise MCP tools or the readwise CLI to retrieve documents.
What it helps with
- test recall of a recently read article
- identify the main claims in a document
- check understanding of highlighted passages
- apply a text’s ideas to current work
Example prompts for the agent
- Quiz me on something I recently read in Readwise Reader.
- Find the article about software architecture in my Readwise Reader and test what I remember.
- Quiz me on the document with ID
12345.
How to install quiz
1Skills CLI (Vercel)
npx skills add readwiseio/readwise-skills --skill quiz -a claude-code2Manually: put the files in place
~/.claude/skills/quiz/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/quiz/
1Skills CLI (Vercel)
npx skills add readwiseio/readwise-skills --skill quiz -a codex2Manually: put the files in place
.agents/skills/quiz/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add readwiseio/readwise-skills --skill quiz -a cursor2Manually: put the files in place
.cursor/skills/quiz/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install readwiseio/readwise-skills quiz2Manually: put the files in place
.github/skills/quiz/SKILL.md1Skills CLI (Vercel)
npx skills add readwiseio/readwise-skills --skill quiz -a gemini-cli2Platform CLI
gemini skills install https://github.com/readwiseio/readwise-skills --path skills/quizManually: put the files in place
.devin/skills/quiz/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add readwiseio/readwise-skills --skill quiz -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about quiz
How do I install quiz in Claude Code?
Run npx skills add readwiseio/readwise-skills --skill quiz -a claude-code. The skill file is placed at ~/.claude/skills/quiz/SKILL.md.
What does the quiz skill do?
It asks questions about documents in Readwise Reader, grades each answer, and gives a final score and takeaway. Questions are presented one at a time.
Does quiz need a Readwise connection?
Yes. It uses Readwise MCP tools or the readwise CLI to retrieve documents. An optional reader_persona.md file lets it tailor questions to the user.