Update to quran.ai

{
  "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.",
  "included_files": [
    {
      "relative_path": "references/reader-help.md",
      "size_in_bytes": 5291
    }
  ],
  "name": "onboarding",
  "skill_md_contents": "---\nname: onboarding\ndescription: 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.\n---\n\n# Begin studying with quran.ai\n\nMake the first encounter a conversation with the interactive book: **Read,\nSelect, Ask, Discover**, then return to the text through links in the answer.\nFollow the user's immediate purpose; a study starter calls for a meaningful\nreader-and-chat experience. A settings question calls for the relevant help.\n\n## Three ways to begin\n\nRecognize these requests, shorter starter wording, and natural paraphrases by\nmeaning. A pasted exact phrase is not required. Use additional context in the\nuser's request to shape the experience.\n\n| Starter | Approach |\n|---|---|\n| Guide my Qur'an discovery journey with quran.ai's reader and study tools, drawing on our past conversations to suggest some initial topics and passages I might be interested in exploring. | A personal discovery journey. |\n| Take me to an unexpected, powerful Quran verse; help me linger, reflect, and notice more. | A fresh passage for reflection. |\n| What does the Quran claim about God? Help me explore its claims with an open mind, and let my honest follow-up questions guide where we go next. | An open inquiry about God. |\n\n**A personal discovery journey.** Use relevant interests, questions, language\npreferences, and circumstances from the current conversation or available\nmemory of past conversations. In the very first response, open a fitting\npassage and immediately suggest several distinct topics and passages the user\nmight be interested in exploring. Explain each possibility substantively, with\nroughly three to five verified reader links embedded in the prose, spanning\nmeaningful ayahs, passages, or surah openings. These are possible starting\npoints, not a fixed reading path or settled claims about the user's interests.\nMention a connection to shared context when it helps, without reciting private\nbackground or inferring their religion or beliefs. If relevant history is\nunavailable, offer useful starting options without pretending to personalize\nthem. Use the reader and appropriate study tools together; do not defer the\ntopic suggestions to another turn or replace them with an intake interview\nor a tool tutorial. Leave the user free to choose or redirect the journey.\n\n**A fresh passage for reflection.** Choose an unexpected, powerful verse or\nshort passage that rewards close reading. Vary choices rather than always\nreaching for the same familiar verse; do not assume it must match the user's\ncurrent concerns. Fetch it and any surrounding passage needed to understand\nit. Invite an unhurried second reading: help the user linger over an image,\nphrase, contrast, or question and notice something they might have missed.\nGuide reflection in ordinary language, keeping personal reflection distinct\nfrom the text and attributed interpretation. Keep the opening focused, with\nthe passage link and one or two useful linked connections. Treat a surprising\nchoice as an invitation to reflect, not a personal divine message or prediction.\n\n**An open inquiry about God.** Begin with what the Quran claims about God,\nusing a short, grounded opening passage and linked passages that illuminate\nthose claims. Address any specific question the user has already expressed.\nHelp them explore and understand with an open mind, without assuming belief\nor agreement. Present the claims and supporting reasoning clearly, take doubts\nseriously, and distinguish the text from commentary and your own reflection.\nWelcome honest follow-up questions and let them guide what to examine next;\nexplore revelation, Jesus, or spiritual purpose when relevant to those questions.\nLeave room to consider and challenge what they read rather than directing them\nthrough a predetermined tour or scripted debate.\n\n## Deliver the first study experience\n\nRead the [Interactive Study skill](../interactive-study/SKILL.md) and follow its\n**Read, select, ask, discover** workflow for all three starters. It owns reader\nopening, the continuing conversation, selection context, grounding, and exact\ndeep-link handling. Complete both the reader opening and the thoughtful\nresponse; the starter has not been answered by rendering the reader alone.\n\nUse [Tafsir source guide](../grounding-rules/SKILL.md#tafsir-source-guide)\nto select commentary for the user's actual inquiry. Close reading may need linguistic,\nrhetorical, or structural analysis; questions about God may need theological arguments\nand differing interpretations; practical or reflective questions may call for guidance\non conduct, worship, or inner life. Let follow-up questions change the source selection.\n\nKeep the introduction approachable, often about 250–400 words unless the\nuser's request calls for something else. Weave the reader links into the\nexplanation at the points where the user should look, compare, or explore.\nInclude one concrete invitation to select a particular phrase in the opening\npassage and ask a meaningful question about it, followed by freedom to choose\nanother phrase or direction. Offer two or three tailored next questions,\nincluding a way to go deeper and a way to steer elsewhere. The follow-up\nreturns to the same study loop rather than restarting onboarding.\n\n## Setup and later help\n\nDefaults are ready to use. Leave saved preferences unchanged unless the user\nasks to change them; skipping setup never blocks study. New readers follow\nSystem appearance (Navy or Ivory), dock contextual meaning at the top in Word\nmeanings mode, and start with Study tools open in Quick send mode. The reader\nguide opens only when requested.\nAn empty meaning lane is initially collapsed; Arabic language or region hints\ncan also make Collapse lane default to on. Existing saved choices take precedence.\n\nFor **Set up** without a more specific goal, give a brief introduction through\nthe personal starting-point flow; no intake questionnaire is required. If the\nuser wants only an opening or navigation, follow the Interactive Study skill's\nquiet-opening rule. Do not add a guided session to an explicit skip or a\ncontrols-only request.\n\nFor settings, navigation, selection, attachments, or other reader-control\nquestions, read [Reader controls and settings](references/reader-help.md) and\nanswer only the relevant part. Do not open another reader merely to explain\nits controls. Mention that they can ask “help with the reader” when useful.\nThe host's Set up action invokes this skill; it is not a permanent help button.\n"
}