[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill-duckdb-duckdb-docs":3,"mdc-flnlx-key":32,"related-org-duckdb-duckdb-docs":1573,"related-repo-duckdb-duckdb-docs":1688},{"slug":4,"name":4,"fn":5,"description":6,"org":7,"tags":11,"stars":22,"repoUrl":23,"updatedAt":24,"license":25,"forks":26,"topics":27,"repo":28,"sourceUrl":30,"mdContent":31},"duckdb-docs","search DuckDB documentation and blog posts","Search DuckDB and DuckLake documentation and blog posts. Returns relevant doc chunks for a question or keyword using full-text search against a locally cached index.\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},"duckdb","DuckDB","https:\u002F\u002Fpexgzepcugksgbtrxkhf.supabase.co\u002Fstorage\u002Fv1\u002Fobject\u002Fpublic\u002Forg-logos\u002Fduckdb.jpg",[12,16,19],{"name":13,"slug":14,"type":15},"Research","research","tag",{"name":17,"slug":18,"type":15},"Documentation","documentation",{"name":20,"slug":21,"type":15},"Search","search",510,"https:\u002F\u002Fgithub.com\u002Fduckdb\u002Fduckdb-skills","2026-07-12T07:54:38.216517",null,25,[],{"repoUrl":23,"stars":22,"forks":26,"topics":29,"description":25},[],"https:\u002F\u002Fgithub.com\u002Fduckdb\u002Fduckdb-skills\u002Ftree\u002FHEAD\u002Fskills\u002Fduckdb-docs","---\nname: duckdb-docs\ndescription: >\n  Search DuckDB and DuckLake documentation and blog posts. Returns relevant\n  doc chunks for a question or keyword using full-text search against a\n  locally cached index.\nargument-hint: \u003Cquestion or keyword>\nallowed-tools: Bash\n---\n\nYou are helping the user find relevant DuckDB or DuckLake documentation.\n\nQuery: `$@`\n\nFollow these steps in order.\n\n## Step 1 — Check DuckDB is installed\n\n```bash\ncommand -v duckdb\n```\n\nIf not found, delegate to `\u002Fduckdb-skills:install-duckdb` and then continue.\n\n## Step 2 — Ensure required extensions are installed\n\n```bash\nduckdb :memory: -c \"INSTALL httpfs; INSTALL fts;\"\n```\n\nIf this fails, report the error and stop.\n\n## Step 3 — Choose the data source and extract search terms\n\nThe query is: `$@`\n\n### Data source selection\n\nThere are two search indexes available:\n\n| Index | Remote URL | Local cache filename | Versions | Use when |\n|-------|-----------|---------------------|----------|----------|\n| **DuckDB docs + blog** | `https:\u002F\u002Fduckdb.org\u002Fdata\u002Fdocs-search.duckdb` | `duckdb-docs.duckdb` | `lts`, `current`, `blog` | Default — any DuckDB question |\n| **DuckLake docs** | `https:\u002F\u002Fducklake.select\u002Fdata\u002Fdocs-search.duckdb` | `ducklake-docs.duckdb` | `stable`, `preview` | Query mentions DuckLake, catalogs, or DuckLake-specific features |\n\nBoth indexes share the same schema:\n\n| Column | Type | Description |\n|--------|------|-------------|\n| `chunk_id` | `VARCHAR` (PK) | e.g. `stable\u002Fsql\u002Ffunctions\u002Fnumeric#absx` |\n| `page_title` | `VARCHAR` | Page title from front matter |\n| `section` | `VARCHAR` | Section heading (null for page intros) |\n| `breadcrumb` | `VARCHAR` | e.g. `SQL > Functions > Numeric` |\n| `url` | `VARCHAR` | URL path with anchor |\n| `version` | `VARCHAR` | See table above |\n| `text` | `TEXT` | Full markdown of the chunk |\n\nBy default, search **DuckDB docs** and filter to `version = 'lts'`. Use different versions when:\n\n- The user explicitly asks about `current`\u002Fnightly features → `version = 'current'`\n- The user asks about a blog post or wants background\u002Fmotivation → `version = 'blog'`\n- The user asks about DuckLake → search the DuckLake index with `version = 'stable'`\n- When unsure, omit the version filter to search across all versions.\n\n### Search terms\n\nIf the input is a **natural language question** (e.g. \"how do I find the most frequent value\"), extract the key technical terms (nouns, function names, SQL keywords) to form a compact BM25 query string. Drop stop words like \"how\", \"do\", \"I\", \"the\".\n\nIf the input is already a **function name or technical term** (e.g. `arg_max`, `GROUP BY ALL`), use it as-is.\n\nUse the extracted terms as `SEARCH_QUERY` in the next step.\n\n## Step 4 — Ensure local cache is fresh\n\nThe cache lives at `$HOME\u002F.duckdb\u002Fdocs\u002FCACHE_FILENAME` (where `CACHE_FILENAME` is `duckdb-docs.duckdb` or `ducklake-docs.duckdb` per Step 3).\n\nFirst, ensure the directory exists:\n\n```bash\nmkdir -p \"$HOME\u002F.duckdb\u002Fdocs\"\n```\n\nThen check whether the cache file exists and is fresh (≤2 days old):\n\n```bash\nCACHE_FILE=\"$HOME\u002F.duckdb\u002Fdocs\u002FCACHE_FILENAME\"\nif [ -f \"$CACHE_FILE\" ]; then\n    MTIME=$(stat -f %m \"$CACHE_FILE\" 2>\u002Fdev\u002Fnull || stat -c %Y \"$CACHE_FILE\")\n    CACHE_AGE_DAYS=$(( ( $(date +%s) - MTIME ) \u002F 86400 ))\nelse\n    CACHE_AGE_DAYS=999\nfi\necho \"Cache age: $CACHE_AGE_DAYS days\"\n```\n\n**If `CACHE_AGE_DAYS` ≤ 2** → skip to Step 5.\n\n**Otherwise** (stale or missing) → fetch the index:\n\n```bash\nduckdb -c \"\nLOAD httpfs;\nLOAD fts;\nATTACH 'REMOTE_URL' AS remote (READ_ONLY);\nATTACH '$HOME\u002F.duckdb\u002Fdocs\u002FCACHE_FILENAME.tmp' AS tmp;\nCOPY FROM DATABASE remote TO tmp;\n\" && mv \"$HOME\u002F.duckdb\u002Fdocs\u002FCACHE_FILENAME.tmp\" \"$HOME\u002F.duckdb\u002Fdocs\u002FCACHE_FILENAME\"\n```\n\nReplace `REMOTE_URL` and `CACHE_FILENAME` per Step 3. If the fetch fails (network error), report the error and stop.\n\n## Step 5 — Search the docs\n\n```bash\nduckdb \"$HOME\u002F.duckdb\u002Fdocs\u002FCACHE_FILENAME\" -readonly -json -c \"\nLOAD fts;\nSELECT\n    chunk_id, page_title, section, breadcrumb, url, version, text,\n    fts_main_docs_chunks.match_bm25(chunk_id, 'SEARCH_QUERY') AS score\nFROM docs_chunks\nWHERE score IS NOT NULL\n  AND version = 'VERSION'\nORDER BY score DESC\nLIMIT 8;\n\"\n```\n\nReplace `CACHE_FILENAME`, `SEARCH_QUERY`, and `VERSION` per Step 3. Remove the `AND version = 'VERSION'` line if searching across all versions.\n\nIf the user's question could benefit from both DuckDB docs and blog results, run two queries (one with `version = 'stable'`, one with `version = 'blog'`) or omit the version filter entirely.\n\n## Step 6 — Handle errors\n\n- **Extension not installed** (`httpfs` or `fts` not found): run `duckdb :memory: -c \"INSTALL httpfs; INSTALL fts;\"` and retry.\n- **ATTACH fails \u002F network unreachable**: inform the user that the docs index is unavailable and suggest checking their internet connection. The DuckDB index is hosted at `https:\u002F\u002Fduckdb.org\u002Fdata\u002Fdocs-search.duckdb` and the DuckLake index at `https:\u002F\u002Fducklake.select\u002Fdata\u002Fdocs-search.duckdb`.\n- **No results** (all scores NULL or empty result set): try broadening the query — drop the least specific term, or try a single-word version of the query — then retry Step 5. If still no results, tell the user no matching documentation was found and suggest visiting https:\u002F\u002Fduckdb.org\u002Fdocs or https:\u002F\u002Fducklake.select\u002Fdocs directly.\n\n## Step 7 — Present results\n\nFor each result chunk returned (ordered by score descending), format as:\n\n```\n### {section} — {page_title}\n{url}\n\n{text}\n\n---\n```\n\nAfter presenting all chunks, synthesize a concise answer to the user's original question (`$@`) based on the retrieved documentation. If the chunks directly answer the question, lead with the answer before showing the sources.\n",{"data":33,"body":36},{"name":4,"description":6,"argument-hint":34,"allowed-tools":35},"\u003Cquestion or keyword>","Bash",{"type":37,"children":38},"root",[39,47,59,64,71,105,118,124,165,170,176,186,193,198,350,355,571,591,641,647,659,686,699,705,740,745,784,789,1085,1103,1113,1235,1255,1261,1390,1423,1442,1448,1534,1540,1545,1555,1567],{"type":40,"tag":41,"props":42,"children":43},"element","p",{},[44],{"type":45,"value":46},"text","You are helping the user find relevant DuckDB or DuckLake documentation.",{"type":40,"tag":41,"props":48,"children":49},{},[50,52],{"type":45,"value":51},"Query: ",{"type":40,"tag":53,"props":54,"children":56},"code",{"className":55},[],[57],{"type":45,"value":58},"$@",{"type":40,"tag":41,"props":60,"children":61},{},[62],{"type":45,"value":63},"Follow these steps in order.",{"type":40,"tag":65,"props":66,"children":68},"h2",{"id":67},"step-1-check-duckdb-is-installed",[69],{"type":45,"value":70},"Step 1 — Check DuckDB is installed",{"type":40,"tag":72,"props":73,"children":78},"pre",{"className":74,"code":75,"language":76,"meta":77,"style":77},"language-bash shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","command -v duckdb\n","bash","",[79],{"type":40,"tag":53,"props":80,"children":81},{"__ignoreMap":77},[82],{"type":40,"tag":83,"props":84,"children":87},"span",{"class":85,"line":86},"line",1,[88,94,100],{"type":40,"tag":83,"props":89,"children":91},{"style":90},"--shiki-light:#6182B8;--shiki-default:#82AAFF;--shiki-dark:#82AAFF",[92],{"type":45,"value":93},"command",{"type":40,"tag":83,"props":95,"children":97},{"style":96},"--shiki-light:#91B859;--shiki-default:#C3E88D;--shiki-dark:#C3E88D",[98],{"type":45,"value":99}," -v",{"type":40,"tag":83,"props":101,"children":102},{"style":96},[103],{"type":45,"value":104}," duckdb\n",{"type":40,"tag":41,"props":106,"children":107},{},[108,110,116],{"type":45,"value":109},"If not found, delegate to ",{"type":40,"tag":53,"props":111,"children":113},{"className":112},[],[114],{"type":45,"value":115},"\u002Fduckdb-skills:install-duckdb",{"type":45,"value":117}," and then continue.",{"type":40,"tag":65,"props":119,"children":121},{"id":120},"step-2-ensure-required-extensions-are-installed",[122],{"type":45,"value":123},"Step 2 — Ensure required extensions are installed",{"type":40,"tag":72,"props":125,"children":127},{"className":74,"code":126,"language":76,"meta":77,"style":77},"duckdb :memory: -c \"INSTALL httpfs; INSTALL fts;\"\n",[128],{"type":40,"tag":53,"props":129,"children":130},{"__ignoreMap":77},[131],{"type":40,"tag":83,"props":132,"children":133},{"class":85,"line":86},[134,139,144,149,155,160],{"type":40,"tag":83,"props":135,"children":137},{"style":136},"--shiki-light:#E2931D;--shiki-default:#FFCB6B;--shiki-dark:#FFCB6B",[138],{"type":45,"value":8},{"type":40,"tag":83,"props":140,"children":141},{"style":96},[142],{"type":45,"value":143}," :memory:",{"type":40,"tag":83,"props":145,"children":146},{"style":96},[147],{"type":45,"value":148}," -c",{"type":40,"tag":83,"props":150,"children":152},{"style":151},"--shiki-light:#39ADB5;--shiki-default:#89DDFF;--shiki-dark:#89DDFF",[153],{"type":45,"value":154}," \"",{"type":40,"tag":83,"props":156,"children":157},{"style":96},[158],{"type":45,"value":159},"INSTALL httpfs; INSTALL fts;",{"type":40,"tag":83,"props":161,"children":162},{"style":151},[163],{"type":45,"value":164},"\"\n",{"type":40,"tag":41,"props":166,"children":167},{},[168],{"type":45,"value":169},"If this fails, report the error and stop.",{"type":40,"tag":65,"props":171,"children":173},{"id":172},"step-3-choose-the-data-source-and-extract-search-terms",[174],{"type":45,"value":175},"Step 3 — Choose the data source and extract search terms",{"type":40,"tag":41,"props":177,"children":178},{},[179,181],{"type":45,"value":180},"The query is: ",{"type":40,"tag":53,"props":182,"children":184},{"className":183},[],[185],{"type":45,"value":58},{"type":40,"tag":187,"props":188,"children":190},"h3",{"id":189},"data-source-selection",[191],{"type":45,"value":192},"Data source selection",{"type":40,"tag":41,"props":194,"children":195},{},[196],{"type":45,"value":197},"There are two search indexes available:",{"type":40,"tag":199,"props":200,"children":201},"table",{},[202,236],{"type":40,"tag":203,"props":204,"children":205},"thead",{},[206],{"type":40,"tag":207,"props":208,"children":209},"tr",{},[210,216,221,226,231],{"type":40,"tag":211,"props":212,"children":213},"th",{},[214],{"type":45,"value":215},"Index",{"type":40,"tag":211,"props":217,"children":218},{},[219],{"type":45,"value":220},"Remote URL",{"type":40,"tag":211,"props":222,"children":223},{},[224],{"type":45,"value":225},"Local cache filename",{"type":40,"tag":211,"props":227,"children":228},{},[229],{"type":45,"value":230},"Versions",{"type":40,"tag":211,"props":232,"children":233},{},[234],{"type":45,"value":235},"Use when",{"type":40,"tag":237,"props":238,"children":239},"tbody",{},[240,300],{"type":40,"tag":207,"props":241,"children":242},{},[243,253,262,271,295],{"type":40,"tag":244,"props":245,"children":246},"td",{},[247],{"type":40,"tag":248,"props":249,"children":250},"strong",{},[251],{"type":45,"value":252},"DuckDB docs + blog",{"type":40,"tag":244,"props":254,"children":255},{},[256],{"type":40,"tag":53,"props":257,"children":259},{"className":258},[],[260],{"type":45,"value":261},"https:\u002F\u002Fduckdb.org\u002Fdata\u002Fdocs-search.duckdb",{"type":40,"tag":244,"props":263,"children":264},{},[265],{"type":40,"tag":53,"props":266,"children":268},{"className":267},[],[269],{"type":45,"value":270},"duckdb-docs.duckdb",{"type":40,"tag":244,"props":272,"children":273},{},[274,280,282,288,289],{"type":40,"tag":53,"props":275,"children":277},{"className":276},[],[278],{"type":45,"value":279},"lts",{"type":45,"value":281},", ",{"type":40,"tag":53,"props":283,"children":285},{"className":284},[],[286],{"type":45,"value":287},"current",{"type":45,"value":281},{"type":40,"tag":53,"props":290,"children":292},{"className":291},[],[293],{"type":45,"value":294},"blog",{"type":40,"tag":244,"props":296,"children":297},{},[298],{"type":45,"value":299},"Default — any DuckDB question",{"type":40,"tag":207,"props":301,"children":302},{},[303,311,320,329,345],{"type":40,"tag":244,"props":304,"children":305},{},[306],{"type":40,"tag":248,"props":307,"children":308},{},[309],{"type":45,"value":310},"DuckLake docs",{"type":40,"tag":244,"props":312,"children":313},{},[314],{"type":40,"tag":53,"props":315,"children":317},{"className":316},[],[318],{"type":45,"value":319},"https:\u002F\u002Fducklake.select\u002Fdata\u002Fdocs-search.duckdb",{"type":40,"tag":244,"props":321,"children":322},{},[323],{"type":40,"tag":53,"props":324,"children":326},{"className":325},[],[327],{"type":45,"value":328},"ducklake-docs.duckdb",{"type":40,"tag":244,"props":330,"children":331},{},[332,338,339],{"type":40,"tag":53,"props":333,"children":335},{"className":334},[],[336],{"type":45,"value":337},"stable",{"type":45,"value":281},{"type":40,"tag":53,"props":340,"children":342},{"className":341},[],[343],{"type":45,"value":344},"preview",{"type":40,"tag":244,"props":346,"children":347},{},[348],{"type":45,"value":349},"Query mentions DuckLake, catalogs, or DuckLake-specific features",{"type":40,"tag":41,"props":351,"children":352},{},[353],{"type":45,"value":354},"Both indexes share the same schema:",{"type":40,"tag":199,"props":356,"children":357},{},[358,379],{"type":40,"tag":203,"props":359,"children":360},{},[361],{"type":40,"tag":207,"props":362,"children":363},{},[364,369,374],{"type":40,"tag":211,"props":365,"children":366},{},[367],{"type":45,"value":368},"Column",{"type":40,"tag":211,"props":370,"children":371},{},[372],{"type":45,"value":373},"Type",{"type":40,"tag":211,"props":375,"children":376},{},[377],{"type":45,"value":378},"Description",{"type":40,"tag":237,"props":380,"children":381},{},[382,416,441,466,496,521,546],{"type":40,"tag":207,"props":383,"children":384},{},[385,394,405],{"type":40,"tag":244,"props":386,"children":387},{},[388],{"type":40,"tag":53,"props":389,"children":391},{"className":390},[],[392],{"type":45,"value":393},"chunk_id",{"type":40,"tag":244,"props":395,"children":396},{},[397,403],{"type":40,"tag":53,"props":398,"children":400},{"className":399},[],[401],{"type":45,"value":402},"VARCHAR",{"type":45,"value":404}," (PK)",{"type":40,"tag":244,"props":406,"children":407},{},[408,410],{"type":45,"value":409},"e.g. ",{"type":40,"tag":53,"props":411,"children":413},{"className":412},[],[414],{"type":45,"value":415},"stable\u002Fsql\u002Ffunctions\u002Fnumeric#absx",{"type":40,"tag":207,"props":417,"children":418},{},[419,428,436],{"type":40,"tag":244,"props":420,"children":421},{},[422],{"type":40,"tag":53,"props":423,"children":425},{"className":424},[],[426],{"type":45,"value":427},"page_title",{"type":40,"tag":244,"props":429,"children":430},{},[431],{"type":40,"tag":53,"props":432,"children":434},{"className":433},[],[435],{"type":45,"value":402},{"type":40,"tag":244,"props":437,"children":438},{},[439],{"type":45,"value":440},"Page title from front matter",{"type":40,"tag":207,"props":442,"children":443},{},[444,453,461],{"type":40,"tag":244,"props":445,"children":446},{},[447],{"type":40,"tag":53,"props":448,"children":450},{"className":449},[],[451],{"type":45,"value":452},"section",{"type":40,"tag":244,"props":454,"children":455},{},[456],{"type":40,"tag":53,"props":457,"children":459},{"className":458},[],[460],{"type":45,"value":402},{"type":40,"tag":244,"props":462,"children":463},{},[464],{"type":45,"value":465},"Section heading (null for page intros)",{"type":40,"tag":207,"props":467,"children":468},{},[469,478,486],{"type":40,"tag":244,"props":470,"children":471},{},[472],{"type":40,"tag":53,"props":473,"children":475},{"className":474},[],[476],{"type":45,"value":477},"breadcrumb",{"type":40,"tag":244,"props":479,"children":480},{},[481],{"type":40,"tag":53,"props":482,"children":484},{"className":483},[],[485],{"type":45,"value":402},{"type":40,"tag":244,"props":487,"children":488},{},[489,490],{"type":45,"value":409},{"type":40,"tag":53,"props":491,"children":493},{"className":492},[],[494],{"type":45,"value":495},"SQL > Functions > Numeric",{"type":40,"tag":207,"props":497,"children":498},{},[499,508,516],{"type":40,"tag":244,"props":500,"children":501},{},[502],{"type":40,"tag":53,"props":503,"children":505},{"className":504},[],[506],{"type":45,"value":507},"url",{"type":40,"tag":244,"props":509,"children":510},{},[511],{"type":40,"tag":53,"props":512,"children":514},{"className":513},[],[515],{"type":45,"value":402},{"type":40,"tag":244,"props":517,"children":518},{},[519],{"type":45,"value":520},"URL path with anchor",{"type":40,"tag":207,"props":522,"children":523},{},[524,533,541],{"type":40,"tag":244,"props":525,"children":526},{},[527],{"type":40,"tag":53,"props":528,"children":530},{"className":529},[],[531],{"type":45,"value":532},"version",{"type":40,"tag":244,"props":534,"children":535},{},[536],{"type":40,"tag":53,"props":537,"children":539},{"className":538},[],[540],{"type":45,"value":402},{"type":40,"tag":244,"props":542,"children":543},{},[544],{"type":45,"value":545},"See table above",{"type":40,"tag":207,"props":547,"children":548},{},[549,557,566],{"type":40,"tag":244,"props":550,"children":551},{},[552],{"type":40,"tag":53,"props":553,"children":555},{"className":554},[],[556],{"type":45,"value":45},{"type":40,"tag":244,"props":558,"children":559},{},[560],{"type":40,"tag":53,"props":561,"children":563},{"className":562},[],[564],{"type":45,"value":565},"TEXT",{"type":40,"tag":244,"props":567,"children":568},{},[569],{"type":45,"value":570},"Full markdown of the chunk",{"type":40,"tag":41,"props":572,"children":573},{},[574,576,581,583,589],{"type":45,"value":575},"By default, search ",{"type":40,"tag":248,"props":577,"children":578},{},[579],{"type":45,"value":580},"DuckDB docs",{"type":45,"value":582}," and filter to ",{"type":40,"tag":53,"props":584,"children":586},{"className":585},[],[587],{"type":45,"value":588},"version = 'lts'",{"type":45,"value":590},". Use different versions when:",{"type":40,"tag":592,"props":593,"children":594},"ul",{},[595,614,625,636],{"type":40,"tag":596,"props":597,"children":598},"li",{},[599,601,606,608],{"type":45,"value":600},"The user explicitly asks about ",{"type":40,"tag":53,"props":602,"children":604},{"className":603},[],[605],{"type":45,"value":287},{"type":45,"value":607},"\u002Fnightly features → ",{"type":40,"tag":53,"props":609,"children":611},{"className":610},[],[612],{"type":45,"value":613},"version = 'current'",{"type":40,"tag":596,"props":615,"children":616},{},[617,619],{"type":45,"value":618},"The user asks about a blog post or wants background\u002Fmotivation → ",{"type":40,"tag":53,"props":620,"children":622},{"className":621},[],[623],{"type":45,"value":624},"version = 'blog'",{"type":40,"tag":596,"props":626,"children":627},{},[628,630],{"type":45,"value":629},"The user asks about DuckLake → search the DuckLake index with ",{"type":40,"tag":53,"props":631,"children":633},{"className":632},[],[634],{"type":45,"value":635},"version = 'stable'",{"type":40,"tag":596,"props":637,"children":638},{},[639],{"type":45,"value":640},"When unsure, omit the version filter to search across all versions.",{"type":40,"tag":187,"props":642,"children":644},{"id":643},"search-terms",[645],{"type":45,"value":646},"Search terms",{"type":40,"tag":41,"props":648,"children":649},{},[650,652,657],{"type":45,"value":651},"If the input is a ",{"type":40,"tag":248,"props":653,"children":654},{},[655],{"type":45,"value":656},"natural language question",{"type":45,"value":658}," (e.g. \"how do I find the most frequent value\"), extract the key technical terms (nouns, function names, SQL keywords) to form a compact BM25 query string. Drop stop words like \"how\", \"do\", \"I\", \"the\".",{"type":40,"tag":41,"props":660,"children":661},{},[662,664,669,671,677,678,684],{"type":45,"value":663},"If the input is already a ",{"type":40,"tag":248,"props":665,"children":666},{},[667],{"type":45,"value":668},"function name or technical term",{"type":45,"value":670}," (e.g. ",{"type":40,"tag":53,"props":672,"children":674},{"className":673},[],[675],{"type":45,"value":676},"arg_max",{"type":45,"value":281},{"type":40,"tag":53,"props":679,"children":681},{"className":680},[],[682],{"type":45,"value":683},"GROUP BY ALL",{"type":45,"value":685},"), use it as-is.",{"type":40,"tag":41,"props":687,"children":688},{},[689,691,697],{"type":45,"value":690},"Use the extracted terms as ",{"type":40,"tag":53,"props":692,"children":694},{"className":693},[],[695],{"type":45,"value":696},"SEARCH_QUERY",{"type":45,"value":698}," in the next step.",{"type":40,"tag":65,"props":700,"children":702},{"id":701},"step-4-ensure-local-cache-is-fresh",[703],{"type":45,"value":704},"Step 4 — Ensure local cache is fresh",{"type":40,"tag":41,"props":706,"children":707},{},[708,710,716,718,724,726,731,733,738],{"type":45,"value":709},"The cache lives at ",{"type":40,"tag":53,"props":711,"children":713},{"className":712},[],[714],{"type":45,"value":715},"$HOME\u002F.duckdb\u002Fdocs\u002FCACHE_FILENAME",{"type":45,"value":717}," (where ",{"type":40,"tag":53,"props":719,"children":721},{"className":720},[],[722],{"type":45,"value":723},"CACHE_FILENAME",{"type":45,"value":725}," is ",{"type":40,"tag":53,"props":727,"children":729},{"className":728},[],[730],{"type":45,"value":270},{"type":45,"value":732}," or ",{"type":40,"tag":53,"props":734,"children":736},{"className":735},[],[737],{"type":45,"value":328},{"type":45,"value":739}," per Step 3).",{"type":40,"tag":41,"props":741,"children":742},{},[743],{"type":45,"value":744},"First, ensure the directory exists:",{"type":40,"tag":72,"props":746,"children":748},{"className":74,"code":747,"language":76,"meta":77,"style":77},"mkdir -p \"$HOME\u002F.duckdb\u002Fdocs\"\n",[749],{"type":40,"tag":53,"props":750,"children":751},{"__ignoreMap":77},[752],{"type":40,"tag":83,"props":753,"children":754},{"class":85,"line":86},[755,760,765,769,775,780],{"type":40,"tag":83,"props":756,"children":757},{"style":136},[758],{"type":45,"value":759},"mkdir",{"type":40,"tag":83,"props":761,"children":762},{"style":96},[763],{"type":45,"value":764}," -p",{"type":40,"tag":83,"props":766,"children":767},{"style":151},[768],{"type":45,"value":154},{"type":40,"tag":83,"props":770,"children":772},{"style":771},"--shiki-light:#90A4AE;--shiki-default:#EEFFFF;--shiki-dark:#BABED8",[773],{"type":45,"value":774},"$HOME",{"type":40,"tag":83,"props":776,"children":777},{"style":96},[778],{"type":45,"value":779},"\u002F.duckdb\u002Fdocs",{"type":40,"tag":83,"props":781,"children":782},{"style":151},[783],{"type":45,"value":164},{"type":40,"tag":41,"props":785,"children":786},{},[787],{"type":45,"value":788},"Then check whether the cache file exists and is fresh (≤2 days old):",{"type":40,"tag":72,"props":790,"children":792},{"className":74,"code":791,"language":76,"meta":77,"style":77},"CACHE_FILE=\"$HOME\u002F.duckdb\u002Fdocs\u002FCACHE_FILENAME\"\nif [ -f \"$CACHE_FILE\" ]; then\n    MTIME=$(stat -f %m \"$CACHE_FILE\" 2>\u002Fdev\u002Fnull || stat -c %Y \"$CACHE_FILE\")\n    CACHE_AGE_DAYS=$(( ( $(date +%s) - MTIME ) \u002F 86400 ))\nelse\n    CACHE_AGE_DAYS=999\nfi\necho \"Cache age: $CACHE_AGE_DAYS days\"\n",[793],{"type":40,"tag":53,"props":794,"children":795},{"__ignoreMap":77},[796,827,870,956,1018,1027,1044,1053],{"type":40,"tag":83,"props":797,"children":798},{"class":85,"line":86},[799,804,809,814,818,823],{"type":40,"tag":83,"props":800,"children":801},{"style":771},[802],{"type":45,"value":803},"CACHE_FILE",{"type":40,"tag":83,"props":805,"children":806},{"style":151},[807],{"type":45,"value":808},"=",{"type":40,"tag":83,"props":810,"children":811},{"style":151},[812],{"type":45,"value":813},"\"",{"type":40,"tag":83,"props":815,"children":816},{"style":771},[817],{"type":45,"value":774},{"type":40,"tag":83,"props":819,"children":820},{"style":96},[821],{"type":45,"value":822},"\u002F.duckdb\u002Fdocs\u002FCACHE_FILENAME",{"type":40,"tag":83,"props":824,"children":825},{"style":151},[826],{"type":45,"value":164},{"type":40,"tag":83,"props":828,"children":830},{"class":85,"line":829},2,[831,837,842,847,851,856,860,865],{"type":40,"tag":83,"props":832,"children":834},{"style":833},"--shiki-light:#39ADB5;--shiki-light-font-style:italic;--shiki-default:#89DDFF;--shiki-default-font-style:italic;--shiki-dark:#89DDFF;--shiki-dark-font-style:italic",[835],{"type":45,"value":836},"if",{"type":40,"tag":83,"props":838,"children":839},{"style":151},[840],{"type":45,"value":841}," [",{"type":40,"tag":83,"props":843,"children":844},{"style":151},[845],{"type":45,"value":846}," -f",{"type":40,"tag":83,"props":848,"children":849},{"style":151},[850],{"type":45,"value":154},{"type":40,"tag":83,"props":852,"children":853},{"style":771},[854],{"type":45,"value":855},"$CACHE_FILE",{"type":40,"tag":83,"props":857,"children":858},{"style":151},[859],{"type":45,"value":813},{"type":40,"tag":83,"props":861,"children":862},{"style":151},[863],{"type":45,"value":864}," ];",{"type":40,"tag":83,"props":866,"children":867},{"style":833},[868],{"type":45,"value":869}," then\n",{"type":40,"tag":83,"props":871,"children":873},{"class":85,"line":872},3,[874,879,884,889,893,898,902,906,910,915,920,925,930,934,939,943,947,951],{"type":40,"tag":83,"props":875,"children":876},{"style":771},[877],{"type":45,"value":878},"    MTIME",{"type":40,"tag":83,"props":880,"children":881},{"style":151},[882],{"type":45,"value":883},"=$(",{"type":40,"tag":83,"props":885,"children":886},{"style":90},[887],{"type":45,"value":888},"stat",{"type":40,"tag":83,"props":890,"children":891},{"style":96},[892],{"type":45,"value":846},{"type":40,"tag":83,"props":894,"children":895},{"style":96},[896],{"type":45,"value":897}," %m",{"type":40,"tag":83,"props":899,"children":900},{"style":151},[901],{"type":45,"value":154},{"type":40,"tag":83,"props":903,"children":904},{"style":771},[905],{"type":45,"value":855},{"type":40,"tag":83,"props":907,"children":908},{"style":151},[909],{"type":45,"value":813},{"type":40,"tag":83,"props":911,"children":912},{"style":151},[913],{"type":45,"value":914}," 2>",{"type":40,"tag":83,"props":916,"children":917},{"style":96},[918],{"type":45,"value":919},"\u002Fdev\u002Fnull",{"type":40,"tag":83,"props":921,"children":922},{"style":151},[923],{"type":45,"value":924}," ||",{"type":40,"tag":83,"props":926,"children":927},{"style":90},[928],{"type":45,"value":929}," stat",{"type":40,"tag":83,"props":931,"children":932},{"style":96},[933],{"type":45,"value":148},{"type":40,"tag":83,"props":935,"children":936},{"style":96},[937],{"type":45,"value":938}," %Y",{"type":40,"tag":83,"props":940,"children":941},{"style":151},[942],{"type":45,"value":154},{"type":40,"tag":83,"props":944,"children":945},{"style":771},[946],{"type":45,"value":855},{"type":40,"tag":83,"props":948,"children":949},{"style":151},[950],{"type":45,"value":813},{"type":40,"tag":83,"props":952,"children":953},{"style":151},[954],{"type":45,"value":955},")\n",{"type":40,"tag":83,"props":957,"children":959},{"class":85,"line":958},4,[960,965,970,975,980,985,990,995,1000,1005,1010,1014],{"type":40,"tag":83,"props":961,"children":962},{"style":771},[963],{"type":45,"value":964},"    CACHE_AGE_DAYS",{"type":40,"tag":83,"props":966,"children":967},{"style":151},[968],{"type":45,"value":969},"=$((",{"type":40,"tag":83,"props":971,"children":972},{"style":151},[973],{"type":45,"value":974}," (",{"type":40,"tag":83,"props":976,"children":977},{"style":136},[978],{"type":45,"value":979}," $(date",{"type":40,"tag":83,"props":981,"children":982},{"style":96},[983],{"type":45,"value":984}," +%s",{"type":40,"tag":83,"props":986,"children":987},{"style":151},[988],{"type":45,"value":989},")",{"type":40,"tag":83,"props":991,"children":992},{"style":136},[993],{"type":45,"value":994}," -",{"type":40,"tag":83,"props":996,"children":997},{"style":96},[998],{"type":45,"value":999}," MTIME",{"type":40,"tag":83,"props":1001,"children":1002},{"style":151},[1003],{"type":45,"value":1004}," )",{"type":40,"tag":83,"props":1006,"children":1007},{"style":771},[1008],{"type":45,"value":1009}," \u002F 86400 ",{"type":40,"tag":83,"props":1011,"children":1012},{"style":151},[1013],{"type":45,"value":989},{"type":40,"tag":83,"props":1015,"children":1016},{"style":771},[1017],{"type":45,"value":955},{"type":40,"tag":83,"props":1019,"children":1021},{"class":85,"line":1020},5,[1022],{"type":40,"tag":83,"props":1023,"children":1024},{"style":833},[1025],{"type":45,"value":1026},"else\n",{"type":40,"tag":83,"props":1028,"children":1030},{"class":85,"line":1029},6,[1031,1035,1039],{"type":40,"tag":83,"props":1032,"children":1033},{"style":771},[1034],{"type":45,"value":964},{"type":40,"tag":83,"props":1036,"children":1037},{"style":151},[1038],{"type":45,"value":808},{"type":40,"tag":83,"props":1040,"children":1041},{"style":96},[1042],{"type":45,"value":1043},"999\n",{"type":40,"tag":83,"props":1045,"children":1047},{"class":85,"line":1046},7,[1048],{"type":40,"tag":83,"props":1049,"children":1050},{"style":833},[1051],{"type":45,"value":1052},"fi\n",{"type":40,"tag":83,"props":1054,"children":1056},{"class":85,"line":1055},8,[1057,1062,1066,1071,1076,1081],{"type":40,"tag":83,"props":1058,"children":1059},{"style":90},[1060],{"type":45,"value":1061},"echo",{"type":40,"tag":83,"props":1063,"children":1064},{"style":151},[1065],{"type":45,"value":154},{"type":40,"tag":83,"props":1067,"children":1068},{"style":96},[1069],{"type":45,"value":1070},"Cache age: ",{"type":40,"tag":83,"props":1072,"children":1073},{"style":771},[1074],{"type":45,"value":1075},"$CACHE_AGE_DAYS",{"type":40,"tag":83,"props":1077,"children":1078},{"style":96},[1079],{"type":45,"value":1080}," days",{"type":40,"tag":83,"props":1082,"children":1083},{"style":151},[1084],{"type":45,"value":164},{"type":40,"tag":41,"props":1086,"children":1087},{},[1088,1101],{"type":40,"tag":248,"props":1089,"children":1090},{},[1091,1093,1099],{"type":45,"value":1092},"If ",{"type":40,"tag":53,"props":1094,"children":1096},{"className":1095},[],[1097],{"type":45,"value":1098},"CACHE_AGE_DAYS",{"type":45,"value":1100}," ≤ 2",{"type":45,"value":1102}," → skip to Step 5.",{"type":40,"tag":41,"props":1104,"children":1105},{},[1106,1111],{"type":40,"tag":248,"props":1107,"children":1108},{},[1109],{"type":45,"value":1110},"Otherwise",{"type":45,"value":1112}," (stale or missing) → fetch the index:",{"type":40,"tag":72,"props":1114,"children":1116},{"className":74,"code":1115,"language":76,"meta":77,"style":77},"duckdb -c \"\nLOAD httpfs;\nLOAD fts;\nATTACH 'REMOTE_URL' AS remote (READ_ONLY);\nATTACH '$HOME\u002F.duckdb\u002Fdocs\u002FCACHE_FILENAME.tmp' AS tmp;\nCOPY FROM DATABASE remote TO tmp;\n\" && mv \"$HOME\u002F.duckdb\u002Fdocs\u002FCACHE_FILENAME.tmp\" \"$HOME\u002F.duckdb\u002Fdocs\u002FCACHE_FILENAME\"\n",[1117],{"type":40,"tag":53,"props":1118,"children":1119},{"__ignoreMap":77},[1120,1136,1144,1152,1160,1177,1185],{"type":40,"tag":83,"props":1121,"children":1122},{"class":85,"line":86},[1123,1127,1131],{"type":40,"tag":83,"props":1124,"children":1125},{"style":136},[1126],{"type":45,"value":8},{"type":40,"tag":83,"props":1128,"children":1129},{"style":96},[1130],{"type":45,"value":148},{"type":40,"tag":83,"props":1132,"children":1133},{"style":151},[1134],{"type":45,"value":1135}," \"\n",{"type":40,"tag":83,"props":1137,"children":1138},{"class":85,"line":829},[1139],{"type":40,"tag":83,"props":1140,"children":1141},{"style":96},[1142],{"type":45,"value":1143},"LOAD httpfs;\n",{"type":40,"tag":83,"props":1145,"children":1146},{"class":85,"line":872},[1147],{"type":40,"tag":83,"props":1148,"children":1149},{"style":96},[1150],{"type":45,"value":1151},"LOAD fts;\n",{"type":40,"tag":83,"props":1153,"children":1154},{"class":85,"line":958},[1155],{"type":40,"tag":83,"props":1156,"children":1157},{"style":96},[1158],{"type":45,"value":1159},"ATTACH 'REMOTE_URL' AS remote (READ_ONLY);\n",{"type":40,"tag":83,"props":1161,"children":1162},{"class":85,"line":1020},[1163,1168,1172],{"type":40,"tag":83,"props":1164,"children":1165},{"style":96},[1166],{"type":45,"value":1167},"ATTACH '",{"type":40,"tag":83,"props":1169,"children":1170},{"style":771},[1171],{"type":45,"value":774},{"type":40,"tag":83,"props":1173,"children":1174},{"style":96},[1175],{"type":45,"value":1176},"\u002F.duckdb\u002Fdocs\u002FCACHE_FILENAME.tmp' AS tmp;\n",{"type":40,"tag":83,"props":1178,"children":1179},{"class":85,"line":1029},[1180],{"type":40,"tag":83,"props":1181,"children":1182},{"style":96},[1183],{"type":45,"value":1184},"COPY FROM DATABASE remote TO tmp;\n",{"type":40,"tag":83,"props":1186,"children":1187},{"class":85,"line":1046},[1188,1192,1197,1202,1206,1210,1215,1219,1223,1227,1231],{"type":40,"tag":83,"props":1189,"children":1190},{"style":151},[1191],{"type":45,"value":813},{"type":40,"tag":83,"props":1193,"children":1194},{"style":151},[1195],{"type":45,"value":1196}," &&",{"type":40,"tag":83,"props":1198,"children":1199},{"style":136},[1200],{"type":45,"value":1201}," mv",{"type":40,"tag":83,"props":1203,"children":1204},{"style":151},[1205],{"type":45,"value":154},{"type":40,"tag":83,"props":1207,"children":1208},{"style":771},[1209],{"type":45,"value":774},{"type":40,"tag":83,"props":1211,"children":1212},{"style":96},[1213],{"type":45,"value":1214},"\u002F.duckdb\u002Fdocs\u002FCACHE_FILENAME.tmp",{"type":40,"tag":83,"props":1216,"children":1217},{"style":151},[1218],{"type":45,"value":813},{"type":40,"tag":83,"props":1220,"children":1221},{"style":151},[1222],{"type":45,"value":154},{"type":40,"tag":83,"props":1224,"children":1225},{"style":771},[1226],{"type":45,"value":774},{"type":40,"tag":83,"props":1228,"children":1229},{"style":96},[1230],{"type":45,"value":822},{"type":40,"tag":83,"props":1232,"children":1233},{"style":151},[1234],{"type":45,"value":164},{"type":40,"tag":41,"props":1236,"children":1237},{},[1238,1240,1246,1248,1253],{"type":45,"value":1239},"Replace ",{"type":40,"tag":53,"props":1241,"children":1243},{"className":1242},[],[1244],{"type":45,"value":1245},"REMOTE_URL",{"type":45,"value":1247}," and ",{"type":40,"tag":53,"props":1249,"children":1251},{"className":1250},[],[1252],{"type":45,"value":723},{"type":45,"value":1254}," per Step 3. If the fetch fails (network error), report the error and stop.",{"type":40,"tag":65,"props":1256,"children":1258},{"id":1257},"step-5-search-the-docs",[1259],{"type":45,"value":1260},"Step 5 — Search the docs",{"type":40,"tag":72,"props":1262,"children":1264},{"className":74,"code":1263,"language":76,"meta":77,"style":77},"duckdb \"$HOME\u002F.duckdb\u002Fdocs\u002FCACHE_FILENAME\" -readonly -json -c \"\nLOAD fts;\nSELECT\n    chunk_id, page_title, section, breadcrumb, url, version, text,\n    fts_main_docs_chunks.match_bm25(chunk_id, 'SEARCH_QUERY') AS score\nFROM docs_chunks\nWHERE score IS NOT NULL\n  AND version = 'VERSION'\nORDER BY score DESC\nLIMIT 8;\n\"\n",[1265],{"type":40,"tag":53,"props":1266,"children":1267},{"__ignoreMap":77},[1268,1309,1316,1324,1332,1340,1348,1356,1364,1373,1382],{"type":40,"tag":83,"props":1269,"children":1270},{"class":85,"line":86},[1271,1275,1279,1283,1287,1291,1296,1301,1305],{"type":40,"tag":83,"props":1272,"children":1273},{"style":136},[1274],{"type":45,"value":8},{"type":40,"tag":83,"props":1276,"children":1277},{"style":151},[1278],{"type":45,"value":154},{"type":40,"tag":83,"props":1280,"children":1281},{"style":771},[1282],{"type":45,"value":774},{"type":40,"tag":83,"props":1284,"children":1285},{"style":96},[1286],{"type":45,"value":822},{"type":40,"tag":83,"props":1288,"children":1289},{"style":151},[1290],{"type":45,"value":813},{"type":40,"tag":83,"props":1292,"children":1293},{"style":96},[1294],{"type":45,"value":1295}," -readonly",{"type":40,"tag":83,"props":1297,"children":1298},{"style":96},[1299],{"type":45,"value":1300}," -json",{"type":40,"tag":83,"props":1302,"children":1303},{"style":96},[1304],{"type":45,"value":148},{"type":40,"tag":83,"props":1306,"children":1307},{"style":151},[1308],{"type":45,"value":1135},{"type":40,"tag":83,"props":1310,"children":1311},{"class":85,"line":829},[1312],{"type":40,"tag":83,"props":1313,"children":1314},{"style":96},[1315],{"type":45,"value":1151},{"type":40,"tag":83,"props":1317,"children":1318},{"class":85,"line":872},[1319],{"type":40,"tag":83,"props":1320,"children":1321},{"style":96},[1322],{"type":45,"value":1323},"SELECT\n",{"type":40,"tag":83,"props":1325,"children":1326},{"class":85,"line":958},[1327],{"type":40,"tag":83,"props":1328,"children":1329},{"style":96},[1330],{"type":45,"value":1331},"    chunk_id, page_title, section, breadcrumb, url, version, text,\n",{"type":40,"tag":83,"props":1333,"children":1334},{"class":85,"line":1020},[1335],{"type":40,"tag":83,"props":1336,"children":1337},{"style":96},[1338],{"type":45,"value":1339},"    fts_main_docs_chunks.match_bm25(chunk_id, 'SEARCH_QUERY') AS score\n",{"type":40,"tag":83,"props":1341,"children":1342},{"class":85,"line":1029},[1343],{"type":40,"tag":83,"props":1344,"children":1345},{"style":96},[1346],{"type":45,"value":1347},"FROM docs_chunks\n",{"type":40,"tag":83,"props":1349,"children":1350},{"class":85,"line":1046},[1351],{"type":40,"tag":83,"props":1352,"children":1353},{"style":96},[1354],{"type":45,"value":1355},"WHERE score IS NOT NULL\n",{"type":40,"tag":83,"props":1357,"children":1358},{"class":85,"line":1055},[1359],{"type":40,"tag":83,"props":1360,"children":1361},{"style":96},[1362],{"type":45,"value":1363},"  AND version = 'VERSION'\n",{"type":40,"tag":83,"props":1365,"children":1367},{"class":85,"line":1366},9,[1368],{"type":40,"tag":83,"props":1369,"children":1370},{"style":96},[1371],{"type":45,"value":1372},"ORDER BY score DESC\n",{"type":40,"tag":83,"props":1374,"children":1376},{"class":85,"line":1375},10,[1377],{"type":40,"tag":83,"props":1378,"children":1379},{"style":96},[1380],{"type":45,"value":1381},"LIMIT 8;\n",{"type":40,"tag":83,"props":1383,"children":1385},{"class":85,"line":1384},11,[1386],{"type":40,"tag":83,"props":1387,"children":1388},{"style":151},[1389],{"type":45,"value":164},{"type":40,"tag":41,"props":1391,"children":1392},{},[1393,1394,1399,1400,1405,1407,1413,1415,1421],{"type":45,"value":1239},{"type":40,"tag":53,"props":1395,"children":1397},{"className":1396},[],[1398],{"type":45,"value":723},{"type":45,"value":281},{"type":40,"tag":53,"props":1401,"children":1403},{"className":1402},[],[1404],{"type":45,"value":696},{"type":45,"value":1406},", and ",{"type":40,"tag":53,"props":1408,"children":1410},{"className":1409},[],[1411],{"type":45,"value":1412},"VERSION",{"type":45,"value":1414}," per Step 3. Remove the ",{"type":40,"tag":53,"props":1416,"children":1418},{"className":1417},[],[1419],{"type":45,"value":1420},"AND version = 'VERSION'",{"type":45,"value":1422}," line if searching across all versions.",{"type":40,"tag":41,"props":1424,"children":1425},{},[1426,1428,1433,1435,1440],{"type":45,"value":1427},"If the user's question could benefit from both DuckDB docs and blog results, run two queries (one with ",{"type":40,"tag":53,"props":1429,"children":1431},{"className":1430},[],[1432],{"type":45,"value":635},{"type":45,"value":1434},", one with ",{"type":40,"tag":53,"props":1436,"children":1438},{"className":1437},[],[1439],{"type":45,"value":624},{"type":45,"value":1441},") or omit the version filter entirely.",{"type":40,"tag":65,"props":1443,"children":1445},{"id":1444},"step-6-handle-errors",[1446],{"type":45,"value":1447},"Step 6 — Handle errors",{"type":40,"tag":592,"props":1449,"children":1450},{},[1451,1483,1507],{"type":40,"tag":596,"props":1452,"children":1453},{},[1454,1459,1460,1466,1467,1473,1475,1481],{"type":40,"tag":248,"props":1455,"children":1456},{},[1457],{"type":45,"value":1458},"Extension not installed",{"type":45,"value":974},{"type":40,"tag":53,"props":1461,"children":1463},{"className":1462},[],[1464],{"type":45,"value":1465},"httpfs",{"type":45,"value":732},{"type":40,"tag":53,"props":1468,"children":1470},{"className":1469},[],[1471],{"type":45,"value":1472},"fts",{"type":45,"value":1474}," not found): run ",{"type":40,"tag":53,"props":1476,"children":1478},{"className":1477},[],[1479],{"type":45,"value":1480},"duckdb :memory: -c \"INSTALL httpfs; INSTALL fts;\"",{"type":45,"value":1482}," and retry.",{"type":40,"tag":596,"props":1484,"children":1485},{},[1486,1491,1493,1498,1500,1505],{"type":40,"tag":248,"props":1487,"children":1488},{},[1489],{"type":45,"value":1490},"ATTACH fails \u002F network unreachable",{"type":45,"value":1492},": inform the user that the docs index is unavailable and suggest checking their internet connection. The DuckDB index is hosted at ",{"type":40,"tag":53,"props":1494,"children":1496},{"className":1495},[],[1497],{"type":45,"value":261},{"type":45,"value":1499}," and the DuckLake index at ",{"type":40,"tag":53,"props":1501,"children":1503},{"className":1502},[],[1504],{"type":45,"value":319},{"type":45,"value":1506},".",{"type":40,"tag":596,"props":1508,"children":1509},{},[1510,1515,1517,1525,1526,1532],{"type":40,"tag":248,"props":1511,"children":1512},{},[1513],{"type":45,"value":1514},"No results",{"type":45,"value":1516}," (all scores NULL or empty result set): try broadening the query — drop the least specific term, or try a single-word version of the query — then retry Step 5. If still no results, tell the user no matching documentation was found and suggest visiting ",{"type":40,"tag":1518,"props":1519,"children":1523},"a",{"href":1520,"rel":1521},"https:\u002F\u002Fduckdb.org\u002Fdocs",[1522],"nofollow",[1524],{"type":45,"value":1520},{"type":45,"value":732},{"type":40,"tag":1518,"props":1527,"children":1530},{"href":1528,"rel":1529},"https:\u002F\u002Fducklake.select\u002Fdocs",[1522],[1531],{"type":45,"value":1528},{"type":45,"value":1533}," directly.",{"type":40,"tag":65,"props":1535,"children":1537},{"id":1536},"step-7-present-results",[1538],{"type":45,"value":1539},"Step 7 — Present results",{"type":40,"tag":41,"props":1541,"children":1542},{},[1543],{"type":45,"value":1544},"For each result chunk returned (ordered by score descending), format as:",{"type":40,"tag":72,"props":1546,"children":1550},{"className":1547,"code":1549,"language":45},[1548],"language-text","### {section} — {page_title}\n{url}\n\n{text}\n\n---\n",[1551],{"type":40,"tag":53,"props":1552,"children":1553},{"__ignoreMap":77},[1554],{"type":45,"value":1549},{"type":40,"tag":41,"props":1556,"children":1557},{},[1558,1560,1565],{"type":45,"value":1559},"After presenting all chunks, synthesize a concise answer to the user's original question (",{"type":40,"tag":53,"props":1561,"children":1563},{"className":1562},[],[1564],{"type":45,"value":58},{"type":45,"value":1566},") based on the retrieved documentation. If the chunks directly answer the question, lead with the answer before showing the sources.",{"type":40,"tag":1568,"props":1569,"children":1570},"style",{},[1571],{"type":45,"value":1572},"html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}",{"items":1574,"total":1366},[1575,1591,1608,1614,1625,1635,1648,1662,1675],{"slug":1576,"name":1576,"fn":1577,"description":1578,"org":1579,"tags":1580,"stars":22,"repoUrl":23,"updatedAt":1590},"attach-db","attach DuckDB database files for querying","Attach a DuckDB database file for use with \u002Fduckdb-skills:query. Explores the schema (tables, columns, row counts) and writes a SQL state file so subsequent queries can restore this session automatically via duckdb -init.\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1581,1584,1587],{"name":1582,"slug":1583,"type":15},"Data Analysis","data-analysis",{"name":1585,"slug":1586,"type":15},"Database","database",{"name":1588,"slug":1589,"type":15},"SQL","sql","2026-07-12T07:54:35.248848",{"slug":1592,"name":1592,"fn":1593,"description":1594,"org":1595,"tags":1596,"stars":22,"repoUrl":23,"updatedAt":1607},"convert-file","convert data files between formats","Convert any data file to another format: CSV, Parquet, JSON, Excel, GeoJSON, and more. Use when the user says \"convert to parquet\", \"save as xlsx\", \"export as JSON\", \"make this a CSV\", \"turn into parquet\", or any variation of format-to-format conversion for data files. Also triggers when the user wants to write Parquet, Excel, or other binary formats that Claude cannot produce natively.\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1597,1598,1601,1604],{"name":1582,"slug":1583,"type":15},{"name":1599,"slug":1600,"type":15},"Data Engineering","data-engineering",{"name":1602,"slug":1603,"type":15},"Excel","excel",{"name":1605,"slug":1606,"type":15},"Spreadsheets","spreadsheets","2026-07-12T07:54:39.62274",{"slug":4,"name":4,"fn":5,"description":6,"org":1609,"tags":1610,"stars":22,"repoUrl":23,"updatedAt":24},{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1611,1612,1613],{"name":17,"slug":18,"type":15},{"name":13,"slug":14,"type":15},{"name":20,"slug":21,"type":15},{"slug":1615,"name":1615,"fn":1616,"description":1617,"org":1618,"tags":1619,"stars":22,"repoUrl":23,"updatedAt":1624},"install-duckdb","install and update DuckDB extensions","Install or update DuckDB extensions. Each argument is either a plain extension name (installs from core) or name@repo (e.g. magic@community). Pass --update to update extensions instead of installing.\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1620,1621],{"name":1585,"slug":1586,"type":15},{"name":1622,"slug":1623,"type":15},"Engineering","engineering","2026-07-12T07:54:42.330952",{"slug":1626,"name":1626,"fn":1627,"description":1628,"org":1629,"tags":1630,"stars":22,"repoUrl":23,"updatedAt":1634},"query","run SQL queries against DuckDB","Run SQL queries against the attached DuckDB database or ad-hoc against files. Accepts raw SQL or natural language questions. Uses DuckDB Friendly SQL idioms.\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1631,1632,1633],{"name":1582,"slug":1583,"type":15},{"name":1585,"slug":1586,"type":15},{"name":1588,"slug":1589,"type":15},"2026-07-12T07:54:28.352759",{"slug":1636,"name":1636,"fn":1637,"description":1638,"org":1639,"tags":1640,"stars":22,"repoUrl":23,"updatedAt":1647},"read-file","read and profile data files","Read any data file (CSV, JSON, Parquet, Avro, Excel, spatial, SQLite) or remote URL (S3, HTTPS). Use when user references a data file, asks \"what's in this file\", or wants to preview\u002Fprofile a dataset. Not for source code.\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1641,1642,1645,1646],{"name":1582,"slug":1583,"type":15},{"name":1643,"slug":1644,"type":15},"Data Quality","data-quality",{"name":1585,"slug":1586,"type":15},{"name":1588,"slug":1589,"type":15},"2026-07-12T07:54:33.514298",{"slug":1649,"name":1649,"fn":1650,"description":1651,"org":1652,"tags":1653,"stars":22,"repoUrl":23,"updatedAt":1661},"read-memories","recall past Claude Code session logs","Search past Claude Code session logs to recall prior decisions, patterns, or unresolved work. Use when user says \"do you remember\", \"what did we do\", references past conversations, or you need context from prior sessions.\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1654,1657,1660],{"name":1655,"slug":1656,"type":15},"Claude Code","claude-code",{"name":1658,"slug":1659,"type":15},"Memory","memory",{"name":20,"slug":21,"type":15},"2026-07-12T07:54:40.860856",{"slug":1663,"name":1663,"fn":1664,"description":1665,"org":1666,"tags":1667,"stars":22,"repoUrl":23,"updatedAt":1674},"s3-explore","explore and query remote storage data","Explore and query data on S3, Cloudflare R2, GCS, MinIO, or any S3-compatible storage. Use when the user mentions an s3:\u002F\u002F, r2:\u002F\u002F, gs:\u002F\u002F, or gcs:\u002F\u002F URL, asks \"what's in this bucket\", wants to list remote files, preview remote Parquet\u002FCSV\u002FJSON, or query data on object storage without downloading it. Also triggers when the user wants to know the size, schema, or row count of remote datasets.\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1668,1671,1672,1673],{"name":1669,"slug":1670,"type":15},"Cloud","cloud",{"name":1599,"slug":1600,"type":15},{"name":1585,"slug":1586,"type":15},{"name":1588,"slug":1589,"type":15},"2026-07-12T07:54:36.928868",{"slug":1676,"name":1676,"fn":1677,"description":1678,"org":1679,"tags":1680,"stars":22,"repoUrl":23,"updatedAt":1687},"spatial","query spatial data with DuckDB","Answer questions about spatial data using DuckDB. Use when the user mentions locations, coordinates, lat\u002Flng, distances, maps, addresses, \"near\", \"within\", \"closest\", geographic names, or spatial file formats (GeoJSON, Shapefile, GeoPackage, GPX, GeoParquet). Also triggers when the user wants to find places, buildings, or roads — Overture Maps provides free global data on S3 with zero API keys. Handles spatial joins, distance calculations, containment checks, density analysis, and format conversions for geographic data.\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1681,1682,1683,1686],{"name":1582,"slug":1583,"type":15},{"name":1585,"slug":1586,"type":15},{"name":1684,"slug":1685,"type":15},"Maps","maps",{"name":1588,"slug":1589,"type":15},"2026-07-12T07:54:32.004105",{"items":1689,"total":1366},[1690,1696,1703,1709,1714,1720,1727],{"slug":1576,"name":1576,"fn":1577,"description":1578,"org":1691,"tags":1692,"stars":22,"repoUrl":23,"updatedAt":1590},{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1693,1694,1695],{"name":1582,"slug":1583,"type":15},{"name":1585,"slug":1586,"type":15},{"name":1588,"slug":1589,"type":15},{"slug":1592,"name":1592,"fn":1593,"description":1594,"org":1697,"tags":1698,"stars":22,"repoUrl":23,"updatedAt":1607},{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1699,1700,1701,1702],{"name":1582,"slug":1583,"type":15},{"name":1599,"slug":1600,"type":15},{"name":1602,"slug":1603,"type":15},{"name":1605,"slug":1606,"type":15},{"slug":4,"name":4,"fn":5,"description":6,"org":1704,"tags":1705,"stars":22,"repoUrl":23,"updatedAt":24},{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1706,1707,1708],{"name":17,"slug":18,"type":15},{"name":13,"slug":14,"type":15},{"name":20,"slug":21,"type":15},{"slug":1615,"name":1615,"fn":1616,"description":1617,"org":1710,"tags":1711,"stars":22,"repoUrl":23,"updatedAt":1624},{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1712,1713],{"name":1585,"slug":1586,"type":15},{"name":1622,"slug":1623,"type":15},{"slug":1626,"name":1626,"fn":1627,"description":1628,"org":1715,"tags":1716,"stars":22,"repoUrl":23,"updatedAt":1634},{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1717,1718,1719],{"name":1582,"slug":1583,"type":15},{"name":1585,"slug":1586,"type":15},{"name":1588,"slug":1589,"type":15},{"slug":1636,"name":1636,"fn":1637,"description":1638,"org":1721,"tags":1722,"stars":22,"repoUrl":23,"updatedAt":1647},{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1723,1724,1725,1726],{"name":1582,"slug":1583,"type":15},{"name":1643,"slug":1644,"type":15},{"name":1585,"slug":1586,"type":15},{"name":1588,"slug":1589,"type":15},{"slug":1649,"name":1649,"fn":1650,"description":1651,"org":1728,"tags":1729,"stars":22,"repoUrl":23,"updatedAt":1661},{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1730,1731,1732],{"name":1655,"slug":1656,"type":15},{"name":1658,"slug":1659,"type":15},{"name":20,"slug":21,"type":15}]