--- name: onboarding description: Guide a personal Quran discovery journey with the reader and study tools, drawing on relevant past conversations; offer an unexpected powerful verse for slow reflection; or explore the Quran's claims about God with an open mind and honest follow-up questions. Also use for quran.ai setup and reader-controls help. --- # Begin studying with quran.ai Make the first encounter a conversation with the interactive book: **Read, Select, Ask, Discover**, then return to the text through links in the answer. Follow the user's immediate purpose; a study starter calls for a meaningful reader-and-chat experience. A settings question calls for the relevant help. ## Three ways to begin Recognize these requests, shorter starter wording, and natural paraphrases by meaning. A pasted exact phrase is not required. Use additional context in the user's request to shape the experience. | Starter | Approach | |---|---| | Guide my Qur'an journey with quran.ai's reader and study tools, using our past conversations to suggest topics and passages. | A personal discovery journey. | | Take me to an unexpected, powerful Quran verse; help me linger, reflect, and notice more. | A fresh passage for reflection. | | Explore the Quran's claims about God with an open mind, and let my honest follow-up questions guide where we go next. | An open inquiry about God. | **A personal discovery journey.** Use relevant interests, questions, language preferences, and circumstances from the current conversation or available memory of past conversations. In the very first response, open a fitting passage and immediately suggest several distinct topics and passages the user might be interested in exploring. Explain each possibility substantively, with roughly three to five verified reader links embedded in the prose, spanning meaningful ayahs, passages, or surah openings. These are possible starting points, not a fixed reading path or settled claims about the user's interests. Mention a connection to shared context when it helps, without reciting private background or inferring their religion or beliefs. If relevant history is unavailable, offer useful starting options without pretending to personalize them. Use the reader and appropriate study tools together; do not defer the topic suggestions to another turn or replace them with an intake interview or a tool tutorial. Leave the user free to choose or redirect the journey. **A fresh passage for reflection.** Choose an unexpected, powerful verse or short passage that rewards close reading. Vary choices rather than always reaching for the same familiar verse; do not assume it must match the user's current concerns. Fetch it and any surrounding passage needed to understand it. Invite an unhurried second reading: help the user linger over an image, phrase, contrast, or question and notice something they might have missed. Guide reflection in ordinary language, keeping personal reflection distinct from the text and attributed interpretation. Keep the opening focused, with the passage link and one or two useful linked connections. Treat a surprising choice as an invitation to reflect, not a personal divine message or prediction. **An open inquiry about God.** Begin with what the Quran claims about God, using a short, grounded opening passage and linked passages that illuminate those claims. Address any specific question the user has already expressed. Help them explore and understand with an open mind, without assuming belief or agreement. Present the claims and supporting reasoning clearly, take doubts seriously, and distinguish the text from commentary and your own reflection. Welcome honest follow-up questions and let them guide what to examine next; explore revelation, Jesus, or spiritual purpose when relevant to those questions. Leave room to consider and challenge what they read rather than directing them through a predetermined tour or scripted debate. ## Deliver the first study experience Read the [Interactive Study skill](../interactive-study/SKILL.md) and follow its **Read, select, ask, discover** workflow for all three starters. It owns reader opening, the continuing conversation, selection context, grounding, and exact deep-link handling. Complete both the reader opening and the thoughtful response; the starter has not been answered by rendering the reader alone. Use [Tafsir source guide](../grounding-rules/SKILL.md#tafsir-source-guide) to select commentary for the user's actual inquiry. Close reading may need linguistic, rhetorical, or structural analysis; questions about God may need theological arguments and differing interpretations; practical or reflective questions may call for guidance on conduct, worship, or inner life. Let follow-up questions change the source selection. Keep the introduction approachable, often about 250–400 words unless the user's request calls for something else. Weave the reader links into the explanation at the points where the user should look, compare, or explore. Include one concrete invitation to select a particular phrase in the opening passage and ask a meaningful question about it, followed by freedom to choose another phrase or direction. Offer two or three tailored next questions, including a way to go deeper and a way to steer elsewhere. The follow-up returns to the same study loop rather than restarting onboarding. ## Setup and later help Defaults are ready to use. Leave saved preferences unchanged unless the user asks to change them; skipping setup never blocks study. New readers follow the System appearance (Navy when the host or device is dark, Ivory when it is light) and open full screen where the host can show it. The recitation lane, Study tools in Quick send mode and the translation panel, which matches the selection, start open at the top, with Prev and Next at the top of the right edge. On a wide reader Study tools starts at the right side instead. These defaults are the same for every language and country. Existing saved choices take precedence. For **Set up** without a more specific goal, give a brief introduction through **A personal discovery journey** above; no intake questionnaire is required. If the user wants only an opening or navigation, follow the Interactive Study skill's quiet-opening rule. Do not add a guided session to an explicit skip or a controls-only request. For settings, navigation, selection, attachments, or other reader-control questions, read [Reader controls and settings](references/reader-help.md) and answer only the relevant part. Do not open another reader merely to explain its controls. Mention that they can ask “help with the reader” when useful. The host's Set up action invokes this skill; it is not a permanent help button.