[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill-elastic-docs-page-opening-optimizer":3,"mdc--rvm33b-key":33,"related-org-elastic-docs-page-opening-optimizer":1472,"related-repo-elastic-docs-page-opening-optimizer":1646},{"slug":4,"name":4,"fn":5,"description":6,"org":7,"tags":11,"stars":20,"repoUrl":21,"updatedAt":22,"license":23,"forks":24,"topics":25,"repo":28,"sourceUrl":31,"mdContent":32},"docs-page-opening-optimizer","optimize Elastic documentation page openings","Optimize the opening of an Elastic documentation page — H1 title, opening paragraph, and requirements section — following doc type conventions. Use when writing or improving page intros, optimizing titles for discoverability, adding requirements sections, or when the user asks to improve the first lines of a doc page.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},"elastic","Elastic","https:\u002F\u002Fpexgzepcugksgbtrxkhf.supabase.co\u002Fstorage\u002Fv1\u002Fobject\u002Fpublic\u002Forg-logos\u002Felastic.png",[12,16,17],{"name":13,"slug":14,"type":15},"Documentation","documentation","tag",{"name":9,"slug":8,"type":15},{"name":18,"slug":19,"type":15},"Technical Writing","technical-writing",71,"https:\u002F\u002Fgithub.com\u002Felastic\u002Felastic-docs-skills","2026-07-12T07:50:44.050021",null,9,[26,8,27],"docs","skills",{"repoUrl":21,"stars":20,"forks":24,"topics":29,"description":30},[26,8,27],"Instructions for code agents on how to author Elastic docs","https:\u002F\u002Fgithub.com\u002Felastic\u002Felastic-docs-skills\u002Ftree\u002FHEAD\u002Fskills\u002Fauthoring\u002Fpage-opening-optimizer","---\nname: docs-page-opening-optimizer\nversion: 1.0.4\ndescription: Optimize the opening of an Elastic documentation page — H1 title, opening paragraph, and requirements section — following doc type conventions. Use when writing or improving page intros, optimizing titles for discoverability, adding requirements sections, or when the user asks to improve the first lines of a doc page.\nargument-hint: \u003Cfile-or-directory>\ncontext: fork\nallowed-tools: Read, Grep, Glob, Edit, Shell\nsources:\n  - https:\u002F\u002Fwww.elastic.co\u002Fdocs\u002Fcontribute-docs\u002Fcontent-types\u002Foverviews\n  - https:\u002F\u002Fwww.elastic.co\u002Fdocs\u002Fcontribute-docs\u002Fcontent-types\u002Fhow-tos\n  - https:\u002F\u002Fwww.elastic.co\u002Fdocs\u002Fcontribute-docs\u002Fcontent-types\u002Ftutorials\n---\n\u003C!-- Copyright Elasticsearch B.V. and\u002For licensed to Elasticsearch B.V. under one\nor more contributor license agreements. See the NOTICE file distributed with\nthis work for additional information regarding copyright\nownership. Elasticsearch B.V. licenses this file to you under\nthe Apache License, Version 2.0 (the \"License\"); you may\nnot use this file except in compliance with the License.\nYou may obtain a copy of the License at\n\n\thttp:\u002F\u002Fwww.apache.org\u002Flicenses\u002FLICENSE-2.0\n\nUnless required by applicable law or agreed to in writing,\nsoftware distributed under the License is distributed on an\n\"AS IS\" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY\nKIND, either express or implied.  See the License for the\nspecific language governing permissions and limitations\nunder the License. -->\n\nYou are a page opening optimizer for Elastic documentation. Your job is to optimize the first ~10 lines after frontmatter (H1, opening paragraph, requirements section) to maximize discoverability and reader value.\n\n## Inputs\n\n`$ARGUMENTS` is a file path or directory. If a directory, process all `.md` files. If empty, ask the user what to optimize.\n\n## Step 1: Classify the documentation type\n\nRead the file and identify its type. This determines H1 style, opening tone, and whether to add requirements.\n\n| Type | Characteristics | H1 pattern |\n|------|----------------|------------|\n| **Tutorial** | Learning-oriented, hands-on for beginners | \"Get started with [feature]\" |\n| **How-to** | Goal-oriented task instructions | \"Configure [feature]\", \"Troubleshoot [problem]\" |\n| **Reference** | Technical specifications | \"[Feature] settings\", \"[API] reference\" |\n| **Explanation** | Conceptual overviews | \"How [feature] works\" |\n| **Overview** | Parent pages with `children:` in `toc.yml` | Feature name only |\n\nTo detect overview pages, check `toc.yml` for entries with `children:` pointing to the file.\n\n## Step 2: Optimize the H1 title\n\nThe H1 must be:\n\n1. **Discoverable** — include the feature name and context (e.g., \"in Kibana\", \"with ES|QL\")\n2. **Specific** — clearly indicate what the page covers\n3. **Unique** — no other page should share this title\n4. **Anchored** — always include `[anchor-name]` in brackets\n\n```markdown\n# Configure data views in Kibana [configure-data-views]\n```\n\nIf the H1 exceeds ~50 characters, add `navigation_title` to the frontmatter.\n\n## Step 3: Write the opening paragraph\n\nThe opening paragraph (2-4 sentences) immediately follows the H1. It must NOT repeat the frontmatter `description`.\n\n### By doc type\n\n**Tutorial** — Define the feature, explain how it works, state what the tutorial covers:\n```markdown\nElasticsearch Query Language ({{esql}}) makes it easier to explore your data\nin **Discover**. {{esql}} uses a piped syntax to filter, transform, and aggregate\ndata. This tutorial walks you through querying sample data, from basic field\nselection to complex filtering and visualization.\n```\n\n**How-to** — Define the feature, explain what it does, state the value:\n```markdown\nPattern analysis in **Discover** helps you find patterns in unstructured log\nmessages by performing categorization analysis on text fields. It creates\ncategories based on message structures and displays their distribution,\nmaking it easier to identify common patterns and focus on anomalous messages.\n```\n\n**Reference** — Define the subject, state its purpose:\n```markdown\nAPI keys provide secure, token-based authentication for applications accessing\n{{product.elasticsearch}}. Use API keys instead of usernames and passwords when\nintegrating external applications.\n```\n\n**Explanation** — Establish context, state what concepts are covered:\n```markdown\n{{product.elasticsearch}} distributes search requests across multiple shards\nand nodes. Understanding query and fetch phases helps you optimize search\nperformance and troubleshoot slow queries.\n```\n\n**Overview** — State what the feature is, its value, and key capabilities:\n```markdown\n**Discover** is the primary tool for exploring your data in {{product.kibana}}.\nSearch and filter documents, analyze field structures, visualize patterns, and\nsave your findings to reuse later or share with dashboards.\n```\n\n### Key principles\n\n- Don't repeat the frontmatter `description`\n- Don't have two consecutive paragraphs repeating each other\n- Front-load important information\n- Use complete sentences, not bullet-point fragments\n- Spell out acronyms on first use: \"Elasticsearch Query Language ({{esql}})\"\n\n## Step 4: Add a \"Before you begin\" section\n\nAdd `## Before you begin` **only when** all conditions are met:\n- No existing \"Before you begin\", requirements, or prerequisites section in the first 50 lines\n- The page is **not** an overview page\n- At least one requirement is non-obvious\n\n### What to include\n\n- Specific Kibana privilege levels: **All**, **Read**, or **None** for a named feature\n- Non-obvious prerequisites (data that must exist, external systems, special licenses)\n- Version requirements only if the feature requires version > 9.0\n\n### What to exclude\n\n- Obvious prerequisites (\"an existing dashboard\" on \"Edit a dashboard\")\n- Generic system requirements (\"access to Kibana\", \"Elasticsearch must be running\")\n- Procedural details that belong in the main body\n- Version numbers prior to 9.0\n\n### Format\n\nUse an H2 with a descriptive anchor:\n```markdown\n## Before you begin [create-dashboard-before-you-begin]\n\nTo create dashboards, you need:\n\n* [Data indexed into {{product.elasticsearch}}](\u002Fmanage-data\u002Fingest.md) and a [data view](..\u002Fdata-views.md).\n* **All** privilege for the **Dashboard** feature in {{product.kibana}}.\n```\n\nFor pages with few H2 sections and a single simple requirement, use a paragraph instead:\n```markdown\nYou need the **All** privilege for the **Dashboard** feature.\n```\n\n## Step 5: Enforce substitutions\n\nReplace hardcoded product names with Jinja2 substitutes:\n- `{{product.kibana}}`, `{{product.elasticsearch}}`\n- `{{esql}}`, `{{data-source}}`, `{{data-sources}}`\n- `{{ece}}`, `{{eck}}`, `{{ech}}`\n\nUse **bold** for UI elements (buttons, apps, field labels). Use `monospace` for technical elements (commands, file paths, settings).\n\n## Step 6: Lint\n\nRun Vale on the modified file immediately after editing. Fix all errors in the opening section before moving to the next file.\n\n```bash\nvale \u003Cfile>\n```\n\n## Pre-flight checks\n\nBefore modifying any file, verify:\n\n1. **Important\u002Fwarning admonitions** in the first ~20 lines — **never** modify, move, or rewrite them. Edit only the content around them.\n2. **Overview page** (has `children:` in `toc.yml`) — do **not** add a \"Before you begin\" section.\n3. **Pre-9.0 version references** — remove them (these docs are for Stack 9+). Only keep versions > 9.0.\n\n## Quality checklist\n\n- [ ] Doc type correctly identified\n- [ ] H1 is unique, specific, searchable, and has an anchor\n- [ ] `navigation_title` added if H1 > 50 characters\n- [ ] Opening paragraph doesn't repeat frontmatter description\n- [ ] Opening conveys purpose, value, and scope\n- [ ] \"Before you begin\" section added where appropriate (not on overview pages)\n- [ ] All substitutions used (no hardcoded product names)\n- [ ] Acronyms spelled out on first use\n- [ ] Bold for UI elements, monospace for technical elements\n- [ ] No pre-9.0 version references\n- [ ] Important\u002Fwarning admonitions left unchanged\n- [ ] Linting run and errors fixed\n",{"data":34,"body":43},{"name":4,"version":35,"description":6,"argument-hint":36,"context":37,"allowed-tools":38,"sources":39},"1.0.4","\u003Cfile-or-directory>","fork","Read, Grep, Glob, Edit, Shell",[40,41,42],"https:\u002F\u002Fwww.elastic.co\u002Fdocs\u002Fcontribute-docs\u002Fcontent-types\u002Foverviews","https:\u002F\u002Fwww.elastic.co\u002Fdocs\u002Fcontribute-docs\u002Fcontent-types\u002Fhow-tos","https:\u002F\u002Fwww.elastic.co\u002Fdocs\u002Fcontribute-docs\u002Fcontent-types\u002Ftutorials",{"type":44,"children":45},"root",[46,54,61,81,87,92,284,303,309,314,367,411,424,430,443,450,459,523,532,588,597,628,637,668,677,720,726,767,773,793,818,824,863,869,892,898,903,1071,1076,1124,1130,1135,1200,1220,1226,1231,1268,1274,1279,1338,1344,1466],{"type":47,"tag":48,"props":49,"children":50},"element","p",{},[51],{"type":52,"value":53},"text","You are a page opening optimizer for Elastic documentation. Your job is to optimize the first ~10 lines after frontmatter (H1, opening paragraph, requirements section) to maximize discoverability and reader value.",{"type":47,"tag":55,"props":56,"children":58},"h2",{"id":57},"inputs",[59],{"type":52,"value":60},"Inputs",{"type":47,"tag":48,"props":62,"children":63},{},[64,71,73,79],{"type":47,"tag":65,"props":66,"children":68},"code",{"className":67},[],[69],{"type":52,"value":70},"$ARGUMENTS",{"type":52,"value":72}," is a file path or directory. If a directory, process all ",{"type":47,"tag":65,"props":74,"children":76},{"className":75},[],[77],{"type":52,"value":78},".md",{"type":52,"value":80}," files. If empty, ask the user what to optimize.",{"type":47,"tag":55,"props":82,"children":84},{"id":83},"step-1-classify-the-documentation-type",[85],{"type":52,"value":86},"Step 1: Classify the documentation type",{"type":47,"tag":48,"props":88,"children":89},{},[90],{"type":52,"value":91},"Read the file and identify its type. This determines H1 style, opening tone, and whether to add requirements.",{"type":47,"tag":93,"props":94,"children":95},"table",{},[96,120],{"type":47,"tag":97,"props":98,"children":99},"thead",{},[100],{"type":47,"tag":101,"props":102,"children":103},"tr",{},[104,110,115],{"type":47,"tag":105,"props":106,"children":107},"th",{},[108],{"type":52,"value":109},"Type",{"type":47,"tag":105,"props":111,"children":112},{},[113],{"type":52,"value":114},"Characteristics",{"type":47,"tag":105,"props":116,"children":117},{},[118],{"type":52,"value":119},"H1 pattern",{"type":47,"tag":121,"props":122,"children":123},"tbody",{},[124,155,188,222,249],{"type":47,"tag":101,"props":125,"children":126},{},[127,137,142],{"type":47,"tag":128,"props":129,"children":130},"td",{},[131],{"type":47,"tag":132,"props":133,"children":134},"strong",{},[135],{"type":52,"value":136},"Tutorial",{"type":47,"tag":128,"props":138,"children":139},{},[140],{"type":52,"value":141},"Learning-oriented, hands-on for beginners",{"type":47,"tag":128,"props":143,"children":144},{},[145,147,153],{"type":52,"value":146},"\"Get started with ",{"type":47,"tag":148,"props":149,"children":150},"span",{},[151],{"type":52,"value":152},"feature",{"type":52,"value":154},"\"",{"type":47,"tag":101,"props":156,"children":157},{},[158,166,171],{"type":47,"tag":128,"props":159,"children":160},{},[161],{"type":47,"tag":132,"props":162,"children":163},{},[164],{"type":52,"value":165},"How-to",{"type":47,"tag":128,"props":167,"children":168},{},[169],{"type":52,"value":170},"Goal-oriented task instructions",{"type":47,"tag":128,"props":172,"children":173},{},[174,176,180,182,187],{"type":52,"value":175},"\"Configure ",{"type":47,"tag":148,"props":177,"children":178},{},[179],{"type":52,"value":152},{"type":52,"value":181},"\", \"Troubleshoot ",{"type":47,"tag":148,"props":183,"children":184},{},[185],{"type":52,"value":186},"problem",{"type":52,"value":154},{"type":47,"tag":101,"props":189,"children":190},{},[191,199,204],{"type":47,"tag":128,"props":192,"children":193},{},[194],{"type":47,"tag":132,"props":195,"children":196},{},[197],{"type":52,"value":198},"Reference",{"type":47,"tag":128,"props":200,"children":201},{},[202],{"type":52,"value":203},"Technical specifications",{"type":47,"tag":128,"props":205,"children":206},{},[207,208,213,215,220],{"type":52,"value":154},{"type":47,"tag":148,"props":209,"children":210},{},[211],{"type":52,"value":212},"Feature",{"type":52,"value":214}," settings\", \"",{"type":47,"tag":148,"props":216,"children":217},{},[218],{"type":52,"value":219},"API",{"type":52,"value":221}," reference\"",{"type":47,"tag":101,"props":223,"children":224},{},[225,233,238],{"type":47,"tag":128,"props":226,"children":227},{},[228],{"type":47,"tag":132,"props":229,"children":230},{},[231],{"type":52,"value":232},"Explanation",{"type":47,"tag":128,"props":234,"children":235},{},[236],{"type":52,"value":237},"Conceptual overviews",{"type":47,"tag":128,"props":239,"children":240},{},[241,243,247],{"type":52,"value":242},"\"How ",{"type":47,"tag":148,"props":244,"children":245},{},[246],{"type":52,"value":152},{"type":52,"value":248}," works\"",{"type":47,"tag":101,"props":250,"children":251},{},[252,260,279],{"type":47,"tag":128,"props":253,"children":254},{},[255],{"type":47,"tag":132,"props":256,"children":257},{},[258],{"type":52,"value":259},"Overview",{"type":47,"tag":128,"props":261,"children":262},{},[263,265,271,273],{"type":52,"value":264},"Parent pages with ",{"type":47,"tag":65,"props":266,"children":268},{"className":267},[],[269],{"type":52,"value":270},"children:",{"type":52,"value":272}," in ",{"type":47,"tag":65,"props":274,"children":276},{"className":275},[],[277],{"type":52,"value":278},"toc.yml",{"type":47,"tag":128,"props":280,"children":281},{},[282],{"type":52,"value":283},"Feature name only",{"type":47,"tag":48,"props":285,"children":286},{},[287,289,294,296,301],{"type":52,"value":288},"To detect overview pages, check ",{"type":47,"tag":65,"props":290,"children":292},{"className":291},[],[293],{"type":52,"value":278},{"type":52,"value":295}," for entries with ",{"type":47,"tag":65,"props":297,"children":299},{"className":298},[],[300],{"type":52,"value":270},{"type":52,"value":302}," pointing to the file.",{"type":47,"tag":55,"props":304,"children":306},{"id":305},"step-2-optimize-the-h1-title",[307],{"type":52,"value":308},"Step 2: Optimize the H1 title",{"type":47,"tag":48,"props":310,"children":311},{},[312],{"type":52,"value":313},"The H1 must be:",{"type":47,"tag":315,"props":316,"children":317},"ol",{},[318,329,339,349],{"type":47,"tag":319,"props":320,"children":321},"li",{},[322,327],{"type":47,"tag":132,"props":323,"children":324},{},[325],{"type":52,"value":326},"Discoverable",{"type":52,"value":328}," — include the feature name and context (e.g., \"in Kibana\", \"with ES|QL\")",{"type":47,"tag":319,"props":330,"children":331},{},[332,337],{"type":47,"tag":132,"props":333,"children":334},{},[335],{"type":52,"value":336},"Specific",{"type":52,"value":338}," — clearly indicate what the page covers",{"type":47,"tag":319,"props":340,"children":341},{},[342,347],{"type":47,"tag":132,"props":343,"children":344},{},[345],{"type":52,"value":346},"Unique",{"type":52,"value":348}," — no other page should share this title",{"type":47,"tag":319,"props":350,"children":351},{},[352,357,359,365],{"type":47,"tag":132,"props":353,"children":354},{},[355],{"type":52,"value":356},"Anchored",{"type":52,"value":358}," — always include ",{"type":47,"tag":65,"props":360,"children":362},{"className":361},[],[363],{"type":52,"value":364},"[anchor-name]",{"type":52,"value":366}," in brackets",{"type":47,"tag":368,"props":369,"children":374},"pre",{"className":370,"code":371,"language":372,"meta":373,"style":373},"language-markdown shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","# Configure data views in Kibana [configure-data-views]\n","markdown","",[375],{"type":47,"tag":65,"props":376,"children":377},{"__ignoreMap":373},[378],{"type":47,"tag":148,"props":379,"children":382},{"class":380,"line":381},"line",1,[383,389,395,400,406],{"type":47,"tag":148,"props":384,"children":386},{"style":385},"--shiki-light:#39ADB5;--shiki-default:#89DDFF;--shiki-dark:#89DDFF",[387],{"type":52,"value":388},"# ",{"type":47,"tag":148,"props":390,"children":392},{"style":391},"--shiki-light:#E2931D;--shiki-default:#FFCB6B;--shiki-dark:#FFCB6B",[393],{"type":52,"value":394},"Configure data views in Kibana ",{"type":47,"tag":148,"props":396,"children":397},{"style":385},[398],{"type":52,"value":399},"[",{"type":47,"tag":148,"props":401,"children":403},{"style":402},"--shiki-light:#91B859;--shiki-default:#C3E88D;--shiki-dark:#C3E88D",[404],{"type":52,"value":405},"configure-data-views",{"type":47,"tag":148,"props":407,"children":408},{"style":385},[409],{"type":52,"value":410},"]\n",{"type":47,"tag":48,"props":412,"children":413},{},[414,416,422],{"type":52,"value":415},"If the H1 exceeds ~50 characters, add ",{"type":47,"tag":65,"props":417,"children":419},{"className":418},[],[420],{"type":52,"value":421},"navigation_title",{"type":52,"value":423}," to the frontmatter.",{"type":47,"tag":55,"props":425,"children":427},{"id":426},"step-3-write-the-opening-paragraph",[428],{"type":52,"value":429},"Step 3: Write the opening paragraph",{"type":47,"tag":48,"props":431,"children":432},{},[433,435,441],{"type":52,"value":434},"The opening paragraph (2-4 sentences) immediately follows the H1. It must NOT repeat the frontmatter ",{"type":47,"tag":65,"props":436,"children":438},{"className":437},[],[439],{"type":52,"value":440},"description",{"type":52,"value":442},".",{"type":47,"tag":444,"props":445,"children":447},"h3",{"id":446},"by-doc-type",[448],{"type":52,"value":449},"By doc type",{"type":47,"tag":48,"props":451,"children":452},{},[453,457],{"type":47,"tag":132,"props":454,"children":455},{},[456],{"type":52,"value":136},{"type":52,"value":458}," — Define the feature, explain how it works, state what the tutorial covers:",{"type":47,"tag":368,"props":460,"children":462},{"className":370,"code":461,"language":372,"meta":373,"style":373},"Elasticsearch Query Language ({{esql}}) makes it easier to explore your data\nin **Discover**. {{esql}} uses a piped syntax to filter, transform, and aggregate\ndata. This tutorial walks you through querying sample data, from basic field\nselection to complex filtering and visualization.\n",[463],{"type":47,"tag":65,"props":464,"children":465},{"__ignoreMap":373},[466,475,505,514],{"type":47,"tag":148,"props":467,"children":468},{"class":380,"line":381},[469],{"type":47,"tag":148,"props":470,"children":472},{"style":471},"--shiki-light:#90A4AE;--shiki-default:#EEFFFF;--shiki-dark:#BABED8",[473],{"type":52,"value":474},"Elasticsearch Query Language ({{esql}}) makes it easier to explore your data\n",{"type":47,"tag":148,"props":476,"children":478},{"class":380,"line":477},2,[479,484,490,496,500],{"type":47,"tag":148,"props":480,"children":481},{"style":471},[482],{"type":52,"value":483},"in ",{"type":47,"tag":148,"props":485,"children":487},{"style":486},"--shiki-light:#39ADB5;--shiki-light-font-weight:bold;--shiki-default:#89DDFF;--shiki-default-font-weight:bold;--shiki-dark:#89DDFF;--shiki-dark-font-weight:bold",[488],{"type":52,"value":489},"**",{"type":47,"tag":148,"props":491,"children":493},{"style":492},"--shiki-light:#E53935;--shiki-light-font-weight:bold;--shiki-default:#F07178;--shiki-default-font-weight:bold;--shiki-dark:#F07178;--shiki-dark-font-weight:bold",[494],{"type":52,"value":495},"Discover",{"type":47,"tag":148,"props":497,"children":498},{"style":486},[499],{"type":52,"value":489},{"type":47,"tag":148,"props":501,"children":502},{"style":471},[503],{"type":52,"value":504},". {{esql}} uses a piped syntax to filter, transform, and aggregate\n",{"type":47,"tag":148,"props":506,"children":508},{"class":380,"line":507},3,[509],{"type":47,"tag":148,"props":510,"children":511},{"style":471},[512],{"type":52,"value":513},"data. This tutorial walks you through querying sample data, from basic field\n",{"type":47,"tag":148,"props":515,"children":517},{"class":380,"line":516},4,[518],{"type":47,"tag":148,"props":519,"children":520},{"style":471},[521],{"type":52,"value":522},"selection to complex filtering and visualization.\n",{"type":47,"tag":48,"props":524,"children":525},{},[526,530],{"type":47,"tag":132,"props":527,"children":528},{},[529],{"type":52,"value":165},{"type":52,"value":531}," — Define the feature, explain what it does, state the value:",{"type":47,"tag":368,"props":533,"children":535},{"className":370,"code":534,"language":372,"meta":373,"style":373},"Pattern analysis in **Discover** helps you find patterns in unstructured log\nmessages by performing categorization analysis on text fields. It creates\ncategories based on message structures and displays their distribution,\nmaking it easier to identify common patterns and focus on anomalous messages.\n",[536],{"type":47,"tag":65,"props":537,"children":538},{"__ignoreMap":373},[539,564,572,580],{"type":47,"tag":148,"props":540,"children":541},{"class":380,"line":381},[542,547,551,555,559],{"type":47,"tag":148,"props":543,"children":544},{"style":471},[545],{"type":52,"value":546},"Pattern analysis in ",{"type":47,"tag":148,"props":548,"children":549},{"style":486},[550],{"type":52,"value":489},{"type":47,"tag":148,"props":552,"children":553},{"style":492},[554],{"type":52,"value":495},{"type":47,"tag":148,"props":556,"children":557},{"style":486},[558],{"type":52,"value":489},{"type":47,"tag":148,"props":560,"children":561},{"style":471},[562],{"type":52,"value":563}," helps you find patterns in unstructured log\n",{"type":47,"tag":148,"props":565,"children":566},{"class":380,"line":477},[567],{"type":47,"tag":148,"props":568,"children":569},{"style":471},[570],{"type":52,"value":571},"messages by performing categorization analysis on text fields. It creates\n",{"type":47,"tag":148,"props":573,"children":574},{"class":380,"line":507},[575],{"type":47,"tag":148,"props":576,"children":577},{"style":471},[578],{"type":52,"value":579},"categories based on message structures and displays their distribution,\n",{"type":47,"tag":148,"props":581,"children":582},{"class":380,"line":516},[583],{"type":47,"tag":148,"props":584,"children":585},{"style":471},[586],{"type":52,"value":587},"making it easier to identify common patterns and focus on anomalous messages.\n",{"type":47,"tag":48,"props":589,"children":590},{},[591,595],{"type":47,"tag":132,"props":592,"children":593},{},[594],{"type":52,"value":198},{"type":52,"value":596}," — Define the subject, state its purpose:",{"type":47,"tag":368,"props":598,"children":600},{"className":370,"code":599,"language":372,"meta":373,"style":373},"API keys provide secure, token-based authentication for applications accessing\n{{product.elasticsearch}}. Use API keys instead of usernames and passwords when\nintegrating external applications.\n",[601],{"type":47,"tag":65,"props":602,"children":603},{"__ignoreMap":373},[604,612,620],{"type":47,"tag":148,"props":605,"children":606},{"class":380,"line":381},[607],{"type":47,"tag":148,"props":608,"children":609},{"style":471},[610],{"type":52,"value":611},"API keys provide secure, token-based authentication for applications accessing\n",{"type":47,"tag":148,"props":613,"children":614},{"class":380,"line":477},[615],{"type":47,"tag":148,"props":616,"children":617},{"style":471},[618],{"type":52,"value":619},"{{product.elasticsearch}}. Use API keys instead of usernames and passwords when\n",{"type":47,"tag":148,"props":621,"children":622},{"class":380,"line":507},[623],{"type":47,"tag":148,"props":624,"children":625},{"style":471},[626],{"type":52,"value":627},"integrating external applications.\n",{"type":47,"tag":48,"props":629,"children":630},{},[631,635],{"type":47,"tag":132,"props":632,"children":633},{},[634],{"type":52,"value":232},{"type":52,"value":636}," — Establish context, state what concepts are covered:",{"type":47,"tag":368,"props":638,"children":640},{"className":370,"code":639,"language":372,"meta":373,"style":373},"{{product.elasticsearch}} distributes search requests across multiple shards\nand nodes. Understanding query and fetch phases helps you optimize search\nperformance and troubleshoot slow queries.\n",[641],{"type":47,"tag":65,"props":642,"children":643},{"__ignoreMap":373},[644,652,660],{"type":47,"tag":148,"props":645,"children":646},{"class":380,"line":381},[647],{"type":47,"tag":148,"props":648,"children":649},{"style":471},[650],{"type":52,"value":651},"{{product.elasticsearch}} distributes search requests across multiple shards\n",{"type":47,"tag":148,"props":653,"children":654},{"class":380,"line":477},[655],{"type":47,"tag":148,"props":656,"children":657},{"style":471},[658],{"type":52,"value":659},"and nodes. Understanding query and fetch phases helps you optimize search\n",{"type":47,"tag":148,"props":661,"children":662},{"class":380,"line":507},[663],{"type":47,"tag":148,"props":664,"children":665},{"style":471},[666],{"type":52,"value":667},"performance and troubleshoot slow queries.\n",{"type":47,"tag":48,"props":669,"children":670},{},[671,675],{"type":47,"tag":132,"props":672,"children":673},{},[674],{"type":52,"value":259},{"type":52,"value":676}," — State what the feature is, its value, and key capabilities:",{"type":47,"tag":368,"props":678,"children":680},{"className":370,"code":679,"language":372,"meta":373,"style":373},"**Discover** is the primary tool for exploring your data in {{product.kibana}}.\nSearch and filter documents, analyze field structures, visualize patterns, and\nsave your findings to reuse later or share with dashboards.\n",[681],{"type":47,"tag":65,"props":682,"children":683},{"__ignoreMap":373},[684,704,712],{"type":47,"tag":148,"props":685,"children":686},{"class":380,"line":381},[687,691,695,699],{"type":47,"tag":148,"props":688,"children":689},{"style":486},[690],{"type":52,"value":489},{"type":47,"tag":148,"props":692,"children":693},{"style":492},[694],{"type":52,"value":495},{"type":47,"tag":148,"props":696,"children":697},{"style":486},[698],{"type":52,"value":489},{"type":47,"tag":148,"props":700,"children":701},{"style":471},[702],{"type":52,"value":703}," is the primary tool for exploring your data in {{product.kibana}}.\n",{"type":47,"tag":148,"props":705,"children":706},{"class":380,"line":477},[707],{"type":47,"tag":148,"props":708,"children":709},{"style":471},[710],{"type":52,"value":711},"Search and filter documents, analyze field structures, visualize patterns, and\n",{"type":47,"tag":148,"props":713,"children":714},{"class":380,"line":507},[715],{"type":47,"tag":148,"props":716,"children":717},{"style":471},[718],{"type":52,"value":719},"save your findings to reuse later or share with dashboards.\n",{"type":47,"tag":444,"props":721,"children":723},{"id":722},"key-principles",[724],{"type":52,"value":725},"Key principles",{"type":47,"tag":727,"props":728,"children":729},"ul",{},[730,740,745,750,755],{"type":47,"tag":319,"props":731,"children":732},{},[733,735],{"type":52,"value":734},"Don't repeat the frontmatter ",{"type":47,"tag":65,"props":736,"children":738},{"className":737},[],[739],{"type":52,"value":440},{"type":47,"tag":319,"props":741,"children":742},{},[743],{"type":52,"value":744},"Don't have two consecutive paragraphs repeating each other",{"type":47,"tag":319,"props":746,"children":747},{},[748],{"type":52,"value":749},"Front-load important information",{"type":47,"tag":319,"props":751,"children":752},{},[753],{"type":52,"value":754},"Use complete sentences, not bullet-point fragments",{"type":47,"tag":319,"props":756,"children":757},{},[758,760,765],{"type":52,"value":759},"Spell out acronyms on first use: \"Elasticsearch Query Language (",{"type":47,"tag":761,"props":762,"children":764},"binding",{"value":763},"esql",[],{"type":52,"value":766},")\"",{"type":47,"tag":55,"props":768,"children":770},{"id":769},"step-4-add-a-before-you-begin-section",[771],{"type":52,"value":772},"Step 4: Add a \"Before you begin\" section",{"type":47,"tag":48,"props":774,"children":775},{},[776,778,784,786,791],{"type":52,"value":777},"Add ",{"type":47,"tag":65,"props":779,"children":781},{"className":780},[],[782],{"type":52,"value":783},"## Before you begin",{"type":52,"value":785}," ",{"type":47,"tag":132,"props":787,"children":788},{},[789],{"type":52,"value":790},"only when",{"type":52,"value":792}," all conditions are met:",{"type":47,"tag":727,"props":794,"children":795},{},[796,801,813],{"type":47,"tag":319,"props":797,"children":798},{},[799],{"type":52,"value":800},"No existing \"Before you begin\", requirements, or prerequisites section in the first 50 lines",{"type":47,"tag":319,"props":802,"children":803},{},[804,806,811],{"type":52,"value":805},"The page is ",{"type":47,"tag":132,"props":807,"children":808},{},[809],{"type":52,"value":810},"not",{"type":52,"value":812}," an overview page",{"type":47,"tag":319,"props":814,"children":815},{},[816],{"type":52,"value":817},"At least one requirement is non-obvious",{"type":47,"tag":444,"props":819,"children":821},{"id":820},"what-to-include",[822],{"type":52,"value":823},"What to include",{"type":47,"tag":727,"props":825,"children":826},{},[827,853,858],{"type":47,"tag":319,"props":828,"children":829},{},[830,832,837,839,844,846,851],{"type":52,"value":831},"Specific Kibana privilege levels: ",{"type":47,"tag":132,"props":833,"children":834},{},[835],{"type":52,"value":836},"All",{"type":52,"value":838},", ",{"type":47,"tag":132,"props":840,"children":841},{},[842],{"type":52,"value":843},"Read",{"type":52,"value":845},", or ",{"type":47,"tag":132,"props":847,"children":848},{},[849],{"type":52,"value":850},"None",{"type":52,"value":852}," for a named feature",{"type":47,"tag":319,"props":854,"children":855},{},[856],{"type":52,"value":857},"Non-obvious prerequisites (data that must exist, external systems, special licenses)",{"type":47,"tag":319,"props":859,"children":860},{},[861],{"type":52,"value":862},"Version requirements only if the feature requires version > 9.0",{"type":47,"tag":444,"props":864,"children":866},{"id":865},"what-to-exclude",[867],{"type":52,"value":868},"What to exclude",{"type":47,"tag":727,"props":870,"children":871},{},[872,877,882,887],{"type":47,"tag":319,"props":873,"children":874},{},[875],{"type":52,"value":876},"Obvious prerequisites (\"an existing dashboard\" on \"Edit a dashboard\")",{"type":47,"tag":319,"props":878,"children":879},{},[880],{"type":52,"value":881},"Generic system requirements (\"access to Kibana\", \"Elasticsearch must be running\")",{"type":47,"tag":319,"props":883,"children":884},{},[885],{"type":52,"value":886},"Procedural details that belong in the main body",{"type":47,"tag":319,"props":888,"children":889},{},[890],{"type":52,"value":891},"Version numbers prior to 9.0",{"type":47,"tag":444,"props":893,"children":895},{"id":894},"format",[896],{"type":52,"value":897},"Format",{"type":47,"tag":48,"props":899,"children":900},{},[901],{"type":52,"value":902},"Use an H2 with a descriptive anchor:",{"type":47,"tag":368,"props":904,"children":906},{"className":370,"code":905,"language":372,"meta":373,"style":373},"## Before you begin [create-dashboard-before-you-begin]\n\nTo create dashboards, you need:\n\n* [Data indexed into {{product.elasticsearch}}](\u002Fmanage-data\u002Fingest.md) and a [data view](..\u002Fdata-views.md).\n* **All** privilege for the **Dashboard** feature in {{product.kibana}}.\n",[907],{"type":47,"tag":65,"props":908,"children":909},{"__ignoreMap":373},[910,936,945,953,960,1027],{"type":47,"tag":148,"props":911,"children":912},{"class":380,"line":381},[913,918,923,927,932],{"type":47,"tag":148,"props":914,"children":915},{"style":385},[916],{"type":52,"value":917},"## ",{"type":47,"tag":148,"props":919,"children":920},{"style":391},[921],{"type":52,"value":922},"Before you begin ",{"type":47,"tag":148,"props":924,"children":925},{"style":385},[926],{"type":52,"value":399},{"type":47,"tag":148,"props":928,"children":929},{"style":402},[930],{"type":52,"value":931},"create-dashboard-before-you-begin",{"type":47,"tag":148,"props":933,"children":934},{"style":385},[935],{"type":52,"value":410},{"type":47,"tag":148,"props":937,"children":938},{"class":380,"line":477},[939],{"type":47,"tag":148,"props":940,"children":942},{"emptyLinePlaceholder":941},true,[943],{"type":52,"value":944},"\n",{"type":47,"tag":148,"props":946,"children":947},{"class":380,"line":507},[948],{"type":47,"tag":148,"props":949,"children":950},{"style":471},[951],{"type":52,"value":952},"To create dashboards, you need:\n",{"type":47,"tag":148,"props":954,"children":955},{"class":380,"line":516},[956],{"type":47,"tag":148,"props":957,"children":958},{"emptyLinePlaceholder":941},[959],{"type":52,"value":944},{"type":47,"tag":148,"props":961,"children":963},{"class":380,"line":962},5,[964,969,974,979,984,990,995,1000,1004,1009,1013,1018,1022],{"type":47,"tag":148,"props":965,"children":966},{"style":385},[967],{"type":52,"value":968},"*",{"type":47,"tag":148,"props":970,"children":971},{"style":385},[972],{"type":52,"value":973}," [",{"type":47,"tag":148,"props":975,"children":976},{"style":402},[977],{"type":52,"value":978},"Data indexed into {{product.elasticsearch}}",{"type":47,"tag":148,"props":980,"children":981},{"style":385},[982],{"type":52,"value":983},"](",{"type":47,"tag":148,"props":985,"children":987},{"style":986},"--shiki-light:#E53935;--shiki-light-text-decoration:underline;--shiki-default:#F07178;--shiki-default-text-decoration:underline;--shiki-dark:#F07178;--shiki-dark-text-decoration:underline",[988],{"type":52,"value":989},"\u002Fmanage-data\u002Fingest.md",{"type":47,"tag":148,"props":991,"children":992},{"style":385},[993],{"type":52,"value":994},")",{"type":47,"tag":148,"props":996,"children":997},{"style":471},[998],{"type":52,"value":999}," and a ",{"type":47,"tag":148,"props":1001,"children":1002},{"style":385},[1003],{"type":52,"value":399},{"type":47,"tag":148,"props":1005,"children":1006},{"style":402},[1007],{"type":52,"value":1008},"data view",{"type":47,"tag":148,"props":1010,"children":1011},{"style":385},[1012],{"type":52,"value":983},{"type":47,"tag":148,"props":1014,"children":1015},{"style":986},[1016],{"type":52,"value":1017},"..\u002Fdata-views.md",{"type":47,"tag":148,"props":1019,"children":1020},{"style":385},[1021],{"type":52,"value":994},{"type":47,"tag":148,"props":1023,"children":1024},{"style":471},[1025],{"type":52,"value":1026},".\n",{"type":47,"tag":148,"props":1028,"children":1030},{"class":380,"line":1029},6,[1031,1035,1040,1044,1048,1053,1057,1062,1066],{"type":47,"tag":148,"props":1032,"children":1033},{"style":385},[1034],{"type":52,"value":968},{"type":47,"tag":148,"props":1036,"children":1037},{"style":486},[1038],{"type":52,"value":1039}," **",{"type":47,"tag":148,"props":1041,"children":1042},{"style":492},[1043],{"type":52,"value":836},{"type":47,"tag":148,"props":1045,"children":1046},{"style":486},[1047],{"type":52,"value":489},{"type":47,"tag":148,"props":1049,"children":1050},{"style":471},[1051],{"type":52,"value":1052}," privilege for the ",{"type":47,"tag":148,"props":1054,"children":1055},{"style":486},[1056],{"type":52,"value":489},{"type":47,"tag":148,"props":1058,"children":1059},{"style":492},[1060],{"type":52,"value":1061},"Dashboard",{"type":47,"tag":148,"props":1063,"children":1064},{"style":486},[1065],{"type":52,"value":489},{"type":47,"tag":148,"props":1067,"children":1068},{"style":471},[1069],{"type":52,"value":1070}," feature in {{product.kibana}}.\n",{"type":47,"tag":48,"props":1072,"children":1073},{},[1074],{"type":52,"value":1075},"For pages with few H2 sections and a single simple requirement, use a paragraph instead:",{"type":47,"tag":368,"props":1077,"children":1079},{"className":370,"code":1078,"language":372,"meta":373,"style":373},"You need the **All** privilege for the **Dashboard** feature.\n",[1080],{"type":47,"tag":65,"props":1081,"children":1082},{"__ignoreMap":373},[1083],{"type":47,"tag":148,"props":1084,"children":1085},{"class":380,"line":381},[1086,1091,1095,1099,1103,1107,1111,1115,1119],{"type":47,"tag":148,"props":1087,"children":1088},{"style":471},[1089],{"type":52,"value":1090},"You need the ",{"type":47,"tag":148,"props":1092,"children":1093},{"style":486},[1094],{"type":52,"value":489},{"type":47,"tag":148,"props":1096,"children":1097},{"style":492},[1098],{"type":52,"value":836},{"type":47,"tag":148,"props":1100,"children":1101},{"style":486},[1102],{"type":52,"value":489},{"type":47,"tag":148,"props":1104,"children":1105},{"style":471},[1106],{"type":52,"value":1052},{"type":47,"tag":148,"props":1108,"children":1109},{"style":486},[1110],{"type":52,"value":489},{"type":47,"tag":148,"props":1112,"children":1113},{"style":492},[1114],{"type":52,"value":1061},{"type":47,"tag":148,"props":1116,"children":1117},{"style":486},[1118],{"type":52,"value":489},{"type":47,"tag":148,"props":1120,"children":1121},{"style":471},[1122],{"type":52,"value":1123}," feature.\n",{"type":47,"tag":55,"props":1125,"children":1127},{"id":1126},"step-5-enforce-substitutions",[1128],{"type":52,"value":1129},"Step 5: Enforce substitutions",{"type":47,"tag":48,"props":1131,"children":1132},{},[1133],{"type":52,"value":1134},"Replace hardcoded product names with Jinja2 substitutes:",{"type":47,"tag":727,"props":1136,"children":1137},{},[1138,1154,1177],{"type":47,"tag":319,"props":1139,"children":1140},{},[1141,1147,1148],{"type":47,"tag":65,"props":1142,"children":1144},{"className":1143},[],[1145],{"type":52,"value":1146},"{{product.kibana}}",{"type":52,"value":838},{"type":47,"tag":65,"props":1149,"children":1151},{"className":1150},[],[1152],{"type":52,"value":1153},"{{product.elasticsearch}}",{"type":47,"tag":319,"props":1155,"children":1156},{},[1157,1163,1164,1170,1171],{"type":47,"tag":65,"props":1158,"children":1160},{"className":1159},[],[1161],{"type":52,"value":1162},"{{esql}}",{"type":52,"value":838},{"type":47,"tag":65,"props":1165,"children":1167},{"className":1166},[],[1168],{"type":52,"value":1169},"{{data-source}}",{"type":52,"value":838},{"type":47,"tag":65,"props":1172,"children":1174},{"className":1173},[],[1175],{"type":52,"value":1176},"{{data-sources}}",{"type":47,"tag":319,"props":1178,"children":1179},{},[1180,1186,1187,1193,1194],{"type":47,"tag":65,"props":1181,"children":1183},{"className":1182},[],[1184],{"type":52,"value":1185},"{{ece}}",{"type":52,"value":838},{"type":47,"tag":65,"props":1188,"children":1190},{"className":1189},[],[1191],{"type":52,"value":1192},"{{eck}}",{"type":52,"value":838},{"type":47,"tag":65,"props":1195,"children":1197},{"className":1196},[],[1198],{"type":52,"value":1199},"{{ech}}",{"type":47,"tag":48,"props":1201,"children":1202},{},[1203,1205,1210,1212,1218],{"type":52,"value":1204},"Use ",{"type":47,"tag":132,"props":1206,"children":1207},{},[1208],{"type":52,"value":1209},"bold",{"type":52,"value":1211}," for UI elements (buttons, apps, field labels). Use ",{"type":47,"tag":65,"props":1213,"children":1215},{"className":1214},[],[1216],{"type":52,"value":1217},"monospace",{"type":52,"value":1219}," for technical elements (commands, file paths, settings).",{"type":47,"tag":55,"props":1221,"children":1223},{"id":1222},"step-6-lint",[1224],{"type":52,"value":1225},"Step 6: Lint",{"type":47,"tag":48,"props":1227,"children":1228},{},[1229],{"type":52,"value":1230},"Run Vale on the modified file immediately after editing. Fix all errors in the opening section before moving to the next file.",{"type":47,"tag":368,"props":1232,"children":1236},{"className":1233,"code":1234,"language":1235,"meta":373,"style":373},"language-bash shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","vale \u003Cfile>\n","bash",[1237],{"type":47,"tag":65,"props":1238,"children":1239},{"__ignoreMap":373},[1240],{"type":47,"tag":148,"props":1241,"children":1242},{"class":380,"line":381},[1243,1248,1253,1258,1263],{"type":47,"tag":148,"props":1244,"children":1245},{"style":391},[1246],{"type":52,"value":1247},"vale",{"type":47,"tag":148,"props":1249,"children":1250},{"style":385},[1251],{"type":52,"value":1252}," \u003C",{"type":47,"tag":148,"props":1254,"children":1255},{"style":402},[1256],{"type":52,"value":1257},"fil",{"type":47,"tag":148,"props":1259,"children":1260},{"style":471},[1261],{"type":52,"value":1262},"e",{"type":47,"tag":148,"props":1264,"children":1265},{"style":385},[1266],{"type":52,"value":1267},">\n",{"type":47,"tag":55,"props":1269,"children":1271},{"id":1270},"pre-flight-checks",[1272],{"type":52,"value":1273},"Pre-flight checks",{"type":47,"tag":48,"props":1275,"children":1276},{},[1277],{"type":52,"value":1278},"Before modifying any file, verify:",{"type":47,"tag":315,"props":1280,"children":1281},{},[1282,1299,1328],{"type":47,"tag":319,"props":1283,"children":1284},{},[1285,1290,1292,1297],{"type":47,"tag":132,"props":1286,"children":1287},{},[1288],{"type":52,"value":1289},"Important\u002Fwarning admonitions",{"type":52,"value":1291}," in the first ~20 lines — ",{"type":47,"tag":132,"props":1293,"children":1294},{},[1295],{"type":52,"value":1296},"never",{"type":52,"value":1298}," modify, move, or rewrite them. Edit only the content around them.",{"type":47,"tag":319,"props":1300,"children":1301},{},[1302,1307,1309,1314,1315,1320,1322,1326],{"type":47,"tag":132,"props":1303,"children":1304},{},[1305],{"type":52,"value":1306},"Overview page",{"type":52,"value":1308}," (has ",{"type":47,"tag":65,"props":1310,"children":1312},{"className":1311},[],[1313],{"type":52,"value":270},{"type":52,"value":272},{"type":47,"tag":65,"props":1316,"children":1318},{"className":1317},[],[1319],{"type":52,"value":278},{"type":52,"value":1321},") — do ",{"type":47,"tag":132,"props":1323,"children":1324},{},[1325],{"type":52,"value":810},{"type":52,"value":1327}," add a \"Before you begin\" section.",{"type":47,"tag":319,"props":1329,"children":1330},{},[1331,1336],{"type":47,"tag":132,"props":1332,"children":1333},{},[1334],{"type":52,"value":1335},"Pre-9.0 version references",{"type":52,"value":1337}," — remove them (these docs are for Stack 9+). Only keep versions > 9.0.",{"type":47,"tag":55,"props":1339,"children":1341},{"id":1340},"quality-checklist",[1342],{"type":52,"value":1343},"Quality checklist",{"type":47,"tag":727,"props":1345,"children":1348},{"className":1346},[1347],"contains-task-list",[1349,1361,1370,1385,1394,1403,1412,1421,1430,1439,1448,1457],{"type":47,"tag":319,"props":1350,"children":1353},{"className":1351},[1352],"task-list-item",[1354,1359],{"type":47,"tag":1355,"props":1356,"children":1358},"input",{"disabled":941,"type":1357},"checkbox",[],{"type":52,"value":1360}," Doc type correctly identified",{"type":47,"tag":319,"props":1362,"children":1364},{"className":1363},[1352],[1365,1368],{"type":47,"tag":1355,"props":1366,"children":1367},{"disabled":941,"type":1357},[],{"type":52,"value":1369}," H1 is unique, specific, searchable, and has an anchor",{"type":47,"tag":319,"props":1371,"children":1373},{"className":1372},[1352],[1374,1377,1378,1383],{"type":47,"tag":1355,"props":1375,"children":1376},{"disabled":941,"type":1357},[],{"type":52,"value":785},{"type":47,"tag":65,"props":1379,"children":1381},{"className":1380},[],[1382],{"type":52,"value":421},{"type":52,"value":1384}," added if H1 > 50 characters",{"type":47,"tag":319,"props":1386,"children":1388},{"className":1387},[1352],[1389,1392],{"type":47,"tag":1355,"props":1390,"children":1391},{"disabled":941,"type":1357},[],{"type":52,"value":1393}," Opening paragraph doesn't repeat frontmatter description",{"type":47,"tag":319,"props":1395,"children":1397},{"className":1396},[1352],[1398,1401],{"type":47,"tag":1355,"props":1399,"children":1400},{"disabled":941,"type":1357},[],{"type":52,"value":1402}," Opening conveys purpose, value, and scope",{"type":47,"tag":319,"props":1404,"children":1406},{"className":1405},[1352],[1407,1410],{"type":47,"tag":1355,"props":1408,"children":1409},{"disabled":941,"type":1357},[],{"type":52,"value":1411}," \"Before you begin\" section added where appropriate (not on overview pages)",{"type":47,"tag":319,"props":1413,"children":1415},{"className":1414},[1352],[1416,1419],{"type":47,"tag":1355,"props":1417,"children":1418},{"disabled":941,"type":1357},[],{"type":52,"value":1420}," All substitutions used (no hardcoded product names)",{"type":47,"tag":319,"props":1422,"children":1424},{"className":1423},[1352],[1425,1428],{"type":47,"tag":1355,"props":1426,"children":1427},{"disabled":941,"type":1357},[],{"type":52,"value":1429}," Acronyms spelled out on first use",{"type":47,"tag":319,"props":1431,"children":1433},{"className":1432},[1352],[1434,1437],{"type":47,"tag":1355,"props":1435,"children":1436},{"disabled":941,"type":1357},[],{"type":52,"value":1438}," Bold for UI elements, monospace for technical elements",{"type":47,"tag":319,"props":1440,"children":1442},{"className":1441},[1352],[1443,1446],{"type":47,"tag":1355,"props":1444,"children":1445},{"disabled":941,"type":1357},[],{"type":52,"value":1447}," No pre-9.0 version references",{"type":47,"tag":319,"props":1449,"children":1451},{"className":1450},[1352],[1452,1455],{"type":47,"tag":1355,"props":1453,"children":1454},{"disabled":941,"type":1357},[],{"type":52,"value":1456}," Important\u002Fwarning admonitions left unchanged",{"type":47,"tag":319,"props":1458,"children":1460},{"className":1459},[1352],[1461,1464],{"type":47,"tag":1355,"props":1462,"children":1463},{"disabled":941,"type":1357},[],{"type":52,"value":1465}," Linting run and errors fixed",{"type":47,"tag":1467,"props":1468,"children":1469},"style",{},[1470],{"type":52,"value":1471},"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":1473,"total":1645},[1474,1493,1510,1525,1544,1556,1566,1581,1593,1608,1619,1632],{"slug":1475,"name":1475,"fn":1476,"description":1477,"org":1478,"tags":1479,"stars":1490,"repoUrl":1491,"updatedAt":1492},"accessing-benchmark-results","retrieve and analyze Rally benchmark results","Retrieve Rally benchmark results from an external Elasticsearch metrics store. Use to list past races, get a single race's overall (per-task) results, chart a metric's trend across multiple runs, compare two races, or check whether a run converged — e.g. \"show me recent geonames races\", \"what's the service_time trend for nyc_taxis over the last 30 days?\", \"compare these two race-ids\". Applies when datastore.type = elasticsearch is set in ~\u002F.rally\u002Frally.ini.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1480,1483,1486,1487],{"name":1481,"slug":1482,"type":15},"Analytics","analytics",{"name":1484,"slug":1485,"type":15},"Data Analysis","data-analysis",{"name":9,"slug":8,"type":15},{"name":1488,"slug":1489,"type":15},"Performance","performance",2027,"https:\u002F\u002Fgithub.com\u002Felastic\u002Frally","2026-07-12T07:46:38.54144",{"slug":1494,"name":1494,"fn":1495,"description":1496,"org":1497,"tags":1498,"stars":1490,"repoUrl":1491,"updatedAt":1509},"developing-rally","develop and debug Rally source code","Work on Rally's own codebase, not running benchmarks with it. Use when setting up the dev environment, running Rally's tests or linters, navigating its source, debugging Rally's own code, or making changes to Rally itself.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1499,1502,1503,1506],{"name":1500,"slug":1501,"type":15},"Debugging","debugging",{"name":9,"slug":8,"type":15},{"name":1504,"slug":1505,"type":15},"Engineering","engineering",{"name":1507,"slug":1508,"type":15},"Local Development","local-development","2026-07-12T07:46:35.976807",{"slug":1511,"name":1511,"fn":1512,"description":1513,"org":1514,"tags":1515,"stars":1490,"repoUrl":1491,"updatedAt":1524},"running-benchmarks","run Rally benchmarks against Elasticsearch","Run Rally benchmarks (races) against Elasticsearch — an existing\u002Fexternal cluster or a Rally-provisioned distribution — and read the summary report. Use when running a race (any pipeline, track, challenge, target-hosts, or auth) or when interpreting throughput, latency, and service_time results.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1516,1517,1520,1521],{"name":9,"slug":8,"type":15},{"name":1518,"slug":1519,"type":15},"Elasticsearch","elasticsearch",{"name":1488,"slug":1489,"type":15},{"name":1522,"slug":1523,"type":15},"Testing","testing","2026-07-12T07:46:37.277964",{"slug":1526,"name":1526,"fn":1527,"description":1528,"org":1529,"tags":1530,"stars":1541,"repoUrl":1542,"updatedAt":1543},"cloud-access-management","manage Elastic Cloud organization access","Manage Elastic Cloud organization access: invite users, assign roles to Serverless projects, and create or revoke Cloud API keys. Use when granting, modifying, or auditing user access.\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1531,1534,1535,1538],{"name":1532,"slug":1533,"type":15},"Cloud","cloud",{"name":9,"slug":8,"type":15},{"name":1536,"slug":1537,"type":15},"Operations","operations",{"name":1539,"slug":1540,"type":15},"Permissions","permissions",531,"https:\u002F\u002Fgithub.com\u002Felastic\u002Fagent-skills","2026-07-12T07:46:44.946285",{"slug":1545,"name":1545,"fn":1546,"description":1547,"org":1548,"tags":1549,"stars":1541,"repoUrl":1542,"updatedAt":1555},"cloud-create-project","create Elastic Cloud Serverless projects","Creates Elastic Cloud Serverless projects (Elasticsearch, Observability, or Security) via the REST API, saves credentials to file, and bootstraps a scoped Elasticsearch API key. Use when creating a new serverless project, provisioning a search or observability environment, or spinning up a new Elastic Cloud project.\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1550,1551,1554],{"name":1532,"slug":1533,"type":15},{"name":1552,"slug":1553,"type":15},"Deployment","deployment",{"name":1518,"slug":1519,"type":15},"2026-07-12T07:46:42.353362",{"slug":1557,"name":1557,"fn":1558,"description":1559,"org":1560,"tags":1561,"stars":1541,"repoUrl":1542,"updatedAt":1565},"cloud-manage-project","manage Elastic Cloud Serverless projects","Manages existing Elastic Cloud Serverless projects: list, get, update, delete, reset credentials, resume, and load saved credentials. Connects to existing projects by resolving endpoints and acquiring scoped Elasticsearch API keys. Use when performing day-2 operations on serverless projects, connecting to an existing project, loading or resetting project credentials, or looking up project details.\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1562,1563,1564],{"name":1532,"slug":1533,"type":15},{"name":1518,"slug":1519,"type":15},{"name":1536,"slug":1537,"type":15},"2026-07-12T07:46:41.097412",{"slug":1567,"name":1567,"fn":1568,"description":1569,"org":1570,"tags":1571,"stars":1541,"repoUrl":1542,"updatedAt":1580},"cloud-network-security","manage Elastic Cloud network security","Manage Serverless network security (traffic filters): create, update, and delete IP filters and AWS PrivateLink VPC filters. Use when restricting network access or configuring private connectivity.\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1572,1573,1574,1577],{"name":1532,"slug":1533,"type":15},{"name":1518,"slug":1519,"type":15},{"name":1575,"slug":1576,"type":15},"Networking","networking",{"name":1578,"slug":1579,"type":15},"Security","security","2026-07-12T07:46:43.675992",{"slug":1582,"name":1582,"fn":1583,"description":1584,"org":1585,"tags":1586,"stars":1541,"repoUrl":1542,"updatedAt":1592},"cloud-setup","configure Elastic Cloud authentication","Configures Elastic Cloud authentication and environment defaults. Use when setting up EC_API_KEY, configuring Cloud API access, or when another cloud skill requires credentials.\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1587,1590,1591],{"name":1588,"slug":1589,"type":15},"Authentication","authentication",{"name":1532,"slug":1533,"type":15},{"name":1518,"slug":1519,"type":15},"2026-07-12T07:46:39.783105",{"slug":1594,"name":1594,"fn":1595,"description":1596,"org":1597,"tags":1598,"stars":1541,"repoUrl":1542,"updatedAt":1607},"elasticsearch-audit","configure Elasticsearch security audit logs","Enable, configure, and query Elasticsearch security audit logs. Use when the task involves audit logging setup, event filtering, or investigating security incidents like failed logins.\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1599,1602,1603,1606],{"name":1600,"slug":1601,"type":15},"Audit","audit",{"name":1518,"slug":1519,"type":15},{"name":1604,"slug":1605,"type":15},"Logs","logs",{"name":1578,"slug":1579,"type":15},"2026-07-12T07:47:35.092599",{"slug":1609,"name":1609,"fn":1610,"description":1611,"org":1612,"tags":1613,"stars":1541,"repoUrl":1542,"updatedAt":1618},"elasticsearch-authn","configure Elasticsearch authentication realms","Authenticate to Elasticsearch using native, file-based, LDAP\u002FAD, SAML, OIDC, Kerberos, JWT, or certificate realms. Use when connecting with credentials, choosing a realm, or managing API keys. Assumes the target realms are already configured.\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1614,1615,1616,1617],{"name":1588,"slug":1589,"type":15},{"name":9,"slug":8,"type":15},{"name":1518,"slug":1519,"type":15},{"name":1578,"slug":1579,"type":15},"2026-07-12T07:47:41.474547",{"slug":1620,"name":1620,"fn":1621,"description":1622,"org":1623,"tags":1624,"stars":1541,"repoUrl":1542,"updatedAt":1631},"elasticsearch-authz","manage Elasticsearch RBAC and security roles","Manage Elasticsearch RBAC: native users, roles, role mappings, document- and field-level security. Use when creating users or roles, assigning privileges, or mapping external realms like LDAP\u002FSAML.\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1625,1626,1627,1630],{"name":9,"slug":8,"type":15},{"name":1518,"slug":1519,"type":15},{"name":1628,"slug":1629,"type":15},"RBAC","rbac",{"name":1578,"slug":1579,"type":15},"2026-07-12T07:47:36.394177",{"slug":1633,"name":1633,"fn":1634,"description":1635,"org":1636,"tags":1637,"stars":1541,"repoUrl":1542,"updatedAt":1644},"elasticsearch-esql","query Elasticsearch data with ES|QL","Execute ES|QL (Elasticsearch Query Language) queries, use when the user wants to query Elasticsearch data, analyze logs, aggregate metrics, explore data, or create charts and dashboards from ES|QL results.\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1638,1639,1640,1641],{"name":1481,"slug":1482,"type":15},{"name":1484,"slug":1485,"type":15},{"name":1518,"slug":1519,"type":15},{"name":1642,"slug":1643,"type":15},"SQL","sql","2026-07-12T07:47:40.249533",86,{"items":1647,"total":1724},[1648,1658,1671,1681,1690,1703,1713],{"slug":1649,"name":1649,"fn":1650,"description":1651,"org":1652,"tags":1653,"stars":20,"repoUrl":21,"updatedAt":1657},"docs-applies-to-tagging","validate applies_to tags in Elastic documentation","Validate and generate applies_to tags in Elastic documentation, including for cumulative docs across versions and deployment types. Use when writing new docs pages, reviewing existing pages for correct applies_to usage, deciding whether to preserve or replace existing version-scoped content, or when content changes lifecycle state (experimental, preview, beta, GA, deprecated, removed).",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1654,1655,1656],{"name":13,"slug":14,"type":15},{"name":9,"slug":8,"type":15},{"name":18,"slug":19,"type":15},"2026-07-12T07:50:42.801473",{"slug":1659,"name":1659,"fn":1660,"description":1661,"org":1662,"tags":1663,"stars":20,"repoUrl":21,"updatedAt":1670},"docs-check-style","check documentation for Elastic style compliance","Check documentation for Elastic style guide compliance using Vale linter output and style rules. Use when writing, editing, or reviewing docs to catch voice, tone, grammar, formatting, accessibility, and word choice issues.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1664,1667,1668,1669],{"name":1665,"slug":1666,"type":15},"Accessibility","accessibility",{"name":13,"slug":14,"type":15},{"name":9,"slug":8,"type":15},{"name":18,"slug":19,"type":15},"2026-07-12T07:49:36.112751",{"slug":1672,"name":1672,"fn":1673,"description":1674,"org":1675,"tags":1676,"stars":20,"repoUrl":21,"updatedAt":1680},"docs-content-type-checker","check Elastic documentation content types","Check a docs-content page against Elastic content type guidelines (overview, how-to, tutorial, troubleshooting, changelog), or classify a proposed page idea against the content types before drafting. Use when the user asks to check content type compliance, validate page structure, review a doc against content type standards, or decide which content type a planned page should use.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1677,1678,1679],{"name":13,"slug":14,"type":15},{"name":9,"slug":8,"type":15},{"name":18,"slug":19,"type":15},"2026-07-12T07:50:36.826563",{"slug":1682,"name":1682,"fn":1683,"description":1684,"org":1685,"tags":1686,"stars":20,"repoUrl":21,"updatedAt":1689},"docs-draft-workflow-docs","draft Elastic Workflows documentation","Draft or update Elastic Workflows documentation pages in explore-analyze\u002Fworkflows\u002F — step references, use cases, how-tos, concepts, and overviews. Use when writing Workflows docs, documenting a step type, turning workflow YAML into documentation, drafting from a doc issue in docs-content or docs-content-internal, or creating a new page under the Workflows docset.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1687,1688],{"name":13,"slug":14,"type":15},{"name":18,"slug":19,"type":15},"2026-07-12T07:48:02.16095",{"slug":1691,"name":1691,"fn":1692,"description":1693,"org":1694,"tags":1695,"stars":20,"repoUrl":21,"updatedAt":1702},"docs-fix-changelog","improve Elastic changelog YAML files","Suggest improved text for changelog YAML files against current Elastic standards. Mirrors the pattern catalog from docs-review-changelog to provide consistent fixes. Includes type-title alignment checking and technical content assessment to catch overly technical titles that need user-focused rewrites. Features repository-aware area validation and enhanced confidence scoring. Supports single files or directories. Fetches canonical guidance to stay in sync. Use after review identifies quality issues, or when drafting new changelogs.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1696,1697,1698,1699],{"name":13,"slug":14,"type":15},{"name":9,"slug":8,"type":15},{"name":18,"slug":19,"type":15},{"name":1700,"slug":1701,"type":15},"YAML","yaml","2026-07-12T07:48:58.570382",{"slug":1704,"name":1704,"fn":1705,"description":1706,"org":1707,"tags":1708,"stars":20,"repoUrl":21,"updatedAt":1712},"docs-flag-jargon-skill","flag Elastic jargon in documentation","Flag Elastic-internal jargon in documentation and suggest plain-language replacements. Use when reviewing, writing, or editing docs to catch terms that external readers would not understand.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1709,1710,1711],{"name":13,"slug":14,"type":15},{"name":9,"slug":8,"type":15},{"name":18,"slug":19,"type":15},"2026-07-12T07:49:34.836748",{"slug":1714,"name":1714,"fn":1715,"description":1716,"org":1717,"tags":1718,"stars":20,"repoUrl":21,"updatedAt":1723},"docs-frontmatter-audit","audit Elastic documentation frontmatter","Audit Elastic documentation files for frontmatter completeness and correctness. Checks products, description, and navigation_title fields across a directory. Use when auditing docs metadata, checking frontmatter quality before publishing, or validating a batch of files.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1719,1720,1721,1722],{"name":1600,"slug":1601,"type":15},{"name":13,"slug":14,"type":15},{"name":9,"slug":8,"type":15},{"name":18,"slug":19,"type":15},"2026-07-12T07:49:39.883351",18]