ReadAware Onboarding

readaware:onboarding — build a base map for this reader

You're interviewing the person using this skill right now, to produce a ~/.claude/readaware/profile.md. readaware:read loads it on every co-reading session to decide what tone, depth, and format to speak to this person with.

Hard rules

• Don't assume you already know them. You don't know who they are, their age, what they've read, or why they're reading this book — ask it out. Don't apply any template persona.
• This is an interview, not a form. The worst possible outcome is a questionnaire like "What's your reading preference? □ Depth □ Fun". Ask specific, hooked, follow-up questions — pull threads from their answers rather than mechanically reciting a list.
• Profile quality = the quality of every future session. A vague "likes deep analysis" is useless; force out executable preferences ("quote the original when giving examples, don't paraphrase"; "I can't get through dense walls of text").
• Default to the user's language throughout (Chinese first, unless they use another).

How to interview

Use AskUserQuestion to throw 1–3 good questions at a time, and dig deeper based on the answers. Cover these dimensions (no need to ask each one literally — draw them out naturally):

1. Who the reader is (the reading-relevant part) — background, knowledge terrain, why this book, what they want out of it. Don't mine privacy; mine what's needed to understand how they read.
2. How to talk to them — tone (academic / peer conversation / sharp), depth, length preference, layout preference (can they take long passages, do they want the conclusion first then the unpacking), and the kind of expression they hate most (AI-speak? a teacherly tone? empty phrases?).
3. What kind of co-reading they want — should you interpret, ask Socratic questions, debate them, play devil's advocate? Should you proactively connect motifs/structure, or only answer what's asked?
4. The lenses they return to — which angles they default to (sociology? philosophy? psychology? history? pure close reading of the text?).
5. Landmines — what makes them close the tab instantly.

Stop once you can draw a clear base map. Don't go on forever.

Output

Organize the interview into ~/.claude/readaware/profile.md, clearly structured as operating instructions for read rather than prose. Suggested sections:

# Reader profile (readaware profile)

## Who the reader is
## How to talk to me (tone · depth · length · layout)
## The kind of co-reading I want
## Lenses and motifs I return to
## Landmines (what not to do)

Run mkdir -p ~/.claude/readaware before writing. After writing, read the profile back to the user and ask them to revise it — this is their base map, they need to own it.

Updating an existing profile

If ~/.claude/readaware/profile.md already exists: read it back to the user first, ask which part they want to change, and update incrementally — don't silently overwrite from scratch. That's the whole point of this being standalone and re-runnable anytime.